常用选项

选项	含义
-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 查看提交历史。

1. 默认不使用参数时，该命令会按时间倒序列出所有的提交历史。

2. 使用 -p 选项列出每次提交的修改内容，可以看到本次提交进行的修改。

3. 使用 -n 列出最近的 n 条记录。例如 git log -2 列出最近两条历史记录。

4. 使用 --stat（statistics 统计的缩写） 列出每次提交的增改行数统计。

5. 使用 --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 行。

6. 使用--author=<name> 指定仅显示指定作者的相关提交

   git log --author=global -2
   

7. 使用--committer=<name> 指定仅显示指定提交者相关的提交。具体使用方法与author相同。

8. 使用 --grep 搜索提交说明中的关键字。

   git log --grep=log -2
   

   用于检索提交说明中含有 log 的提交。

9. 如果只关心某些文件或目录的提交历史，可以在 log 的最后跟上路径，并且需要使用 -- 隔开路径与选项。

   git log --grep=log -2 -- /test
   

   通过 -- 隔开路径与选项，查询到的历史记录只有 test 目录的。

10. 使用 --since 或 --after 显示指定时间之后的提交。

11. 使用 --until 或 --before 显示指定时间之前的提交。

     git log --after="2017-9-2" --before="2017-9-4"
    

    该命令会列出从9月2号（含）到9月4号（含）所有的提交记录。

12. --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>。

1. 如果 start 与 end 都是数字，它表示指定的行号（行号从 1 开始）。如：

   $ git log -L 2,4:a.txt
   

   上述命令就会返回 a.txt 文件第 2 行到第 4 行的变更记录。

2. 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。

3. 对于 -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

其中 > 指向的是被合并分支中跟冲突相关的提交，< 指向的是当前分支中跟冲突相关的提交。