常用选项
| 选项 | 含义 |
|---|---|
| -n | 查看最近 n 条提交记录 |
| --grep <msg> | 搜索提交说明中的关键字 |
| --since="yyyy-m-dd" --until="yyyy-m-d" | 搜索指定时间段内的提交 |
| --after --before | 同 since 与 until |
| --left-right | 用于指向当前的提交到底属性哪个引用 |
| -S"<string>" 或 -G | 用于搜索 string 提交和删除的版本。-G 用于正则表达式 |
| -L | 跟踪指定的行的演变过程 |
| --merge | 显示任何一边接触了合并冲突文件的提交 |
log 命令也可用于指定的文件，只需要将文件与命令通过 -- 分隔即可。如：
$ git log -- ee
该语句只会返回 ee 文件的提交历史。
基本命令
使用 git log 查看提交历史。
默认不使用参数时，该命令会按时间倒序列出所有的提交历史。
使用 -p 选项列出每次提交的修改内容，可以看到本次提交进行的修改。
使用 -n 列出最近的 n 条记录。例如 git log -2 列出最近两条历史记录。
使用 --stat（statistics 统计的缩写） 列出每次提交的增改行数统计。
-
使用 --pretty=<value> 指定日志的输出格式。如
git log --pretty=oneline会将记录放在一行显示。oneline 只显示每一次提交的 SHA1 值以及提交的文字说明。
--pretty 可用的选项有oneline , full , fuller , short 和 format（后需要跟指定的格式）。
- 普通的 git log 会显示如下信息：
$ git log -1 commit ca82a6dff817ec66f44342007202690a93763949 Author: Scott Chacon <schacon@gmail.com> Date: Mon Mar 17 21:52:11 2008 -0700 changed the verison number使用 --pretty=online 时，只会显示 commit 与 最下面的文字说明，并且显示在一行；
使用 --pretty=full 时，会在普通的 git log 基本上多加一条 “Commit” ，它指的是提交者；
使用 --pretty=fuller 时，会在 full 基础上添加 “AuthorDate” 与 "CommitDate"；
使用 --pretty=short 时，会比普通 log 少 Date 行。
-
使用--author=<name> 指定仅显示指定作者的相关提交
git log --author=global -2 使用--committer=<name> 指定仅显示指定提交者相关的提交。具体使用方法与author相同。
-
使用 --grep 搜索提交说明中的关键字。
git log --grep=log -2用于检索提交说明中含有 log 的提交。
-
如果只关心某些文件或目录的提交历史，可以在 log 的最后跟上路径，并且需要使用 -- 隔开路径与选项。
git log --grep=log -2 -- /test通过 -- 隔开路径与选项，查询到的历史记录只有 test 目录的。
使用 --since 或 --after 显示指定时间之后的提交。
-
使用 --until 或 --before 显示指定时间之前的提交。
git log --after="2017-9-2" --before="2017-9-4"该命令会列出从9月2号（含）到9月4号（含）所有的提交记录。
-
--left-right 与 ... 运算符结合使用，用于指明提交到底属于哪个引用。如：
$ git log --left-right dev...master commit < e46a0a492fa5a77a7709ba3d201c9a226297bce1 commit > db496c69ad86e2a4cb5f58a9da2b998498651080 commit > d7b0598e71391add76559f118186b39474468098 commit > 9b3a660fdeda67bd8dcf428719eaf84b1fb412f2
-S 与 -G
-S 用于查找指定的字符串添加或删除的版本。-G 与 -S 类似，只不过 -G 用于正则表达式匹配
注意：-S 与查询的内容之间不能出现空格。
$ git log -S"a11" --oneline
94689ef del a11
9fabba9 clean
9fabba9 是 a11 第一次出现的版本；94689ef 是 a11 删除的版本。
$ git log -G"a1{2}" --oneline
94689ef del a11
9fabba9 clean
返回结果与 -S 一样，只不过 -G 后跟的是正则表达式。
-L
用于查找指定的范围内的行的演变过程。
有两种格式：-L <start>,<end>:<file> 和 -L :<funcname>:<file>。
-
如果 start 与 end 都是数字，它表示指定的行号（行号从 1 开始）。如：
$ git log -L 2,4:a.txt上述命令就会返回 a.txt 文件第 2 行到第 4 行的变更记录。
-
start 与 end 都是正则表达式。
写正则表达式时，表达式需要用 // 包裹起来。
start 将从前一个 -L 范围的末尾（如果有的话）搜索，否则从文件开头搜索。
如果 <start> 是 “^/ regex /”，它将从文件开头搜索。
end 将从 start 给出的行开始搜索。
与直接指定数字相比，使用表达式可以在满足条件的行之间删除或添加行。
$ git log -L "/a3\{2\}/","/a5\{2\}/":aa commit 3a4721694a888a876d062ac90bca03115b3394b7 Author: global <global@mail.com> Date: Thu Mar 29 21:52:52 2018 +0800 a44 diff --git a/aa b/aa --- a/aa +++ b/aa @@ -2,3 +2,4 @@ a33 a4 +a444 a55上述代码会展示满足表达式 a3{2} 的行到满足表达式 a5{2} 的行的变迁过程。
由上例可以发现，最近一次修改后，在 a33 与 a55 之间添加了一行 a444。
-
对于 -L :<funcname>:<file> 可以用于检索 file 文件中 funcname 方法的变迁过程。
$ git log -L :test:test.html commit a6863836d1d54c00035511824758a8da6dfed83b Author: global <global@mail.com> Date: Thu Mar 29 22:00:47 2018 +0800 update test func diff --git a/test.html b/test.html --- a/test.html +++ b/test.html @@ -1,3 +1,4 @@ public void test(){ + print("bb"); print("aa"); }上述命令用于获取 test.html 中 test 方法的变迁过程。
由输出可以知道，最近一次提交是在 test 方法中添加了 print("bb"); 行。
每一次输出的内容都是第 n 次提交与第 n+1 提交的对比结果。+ 号行表示的是第 n+1 次提交添加的行，- 号行表示第 n+1 次提交删掉的行。
--merge
用于显示跟冲突位置相关的提交
在运行 git merge 出现冲突文件后，可以运行 git log --merge 命令查看跟冲突区域相关的提交。如：
$ git log --merge --left-right --oneline
< 86ceb32 update a2
> 5909e8e update dev
其中 > 指向的是被合并分支中跟冲突相关的提交，< 指向的是当前分支中跟冲突相关的提交。
