log 算是 git 当中非常常用的功能了，在提交了若干更新之后，又或者克隆了某个项目，想回顾下提交历史，可以使用 git log 命令查看。
查看所有日志
git log
git log 有许多选项可供特殊筛选
$ git log -p -2
-p 展开显示每次提交的内容差异
-2 表示近两次的更新
查找改动某个文件的所有日志
git log --pretty=oneline somefile.java
git log --oneline somefile.java
git log --pretty=format:"%h %an,%cd : %s" somefile.java
格式化输出
git log --pretty=format:" "
下表列出了常用的格式占位符写法及其代表的意义。
| 选项 | 说明 |
|---|---|
| %H | 提交对象（commit）的完整哈希字串 |
| %h | 提交对象的简短哈希字串 |
| %T | 树对象（tree）的完整哈希字串 |
| %t | 树对象的简短哈希字串 |
| %P | 父对象（parent）的完整哈希字串 |
| %p | 父对象的简短哈希字串 |
| %an | 作者（author）的名字 |
| %ae | 作者的电子邮件地址 |
| %ad | 作者修订日期（可以用 -date= 选项定制格式） |
| %ar | 作者修订日期，按多久以前的方式显示 |
| %cn | 提交者(committer)的名字 |
| %ce | 提交者的电子邮件地址 |
| %cd | 提交日期 |
| %cr | 提交日期，按多久以前的方式显示 |
| %s | 提交说明 |
指定日期、关键字、作者
注意作者与提交者的关系：作者是程序的修改者，提交者是代码提交人。
如指定2天前，作者为“BeginMan”的提交含有关键字'init'的前2条记录：
git log --since=2.days --author=BeginMan --grep=init -2
注意：上面选项后面的参数可以带单双引号，如--author=""BeginMan"""
- 仅显示指定时间之后的提交
git log --since=2.days
- 仅显示指定时间之前的提交
git log --until=10.days
- 仅显示指定作者相关的提交
git log --author=BeginMan
- 仅显示指定提交者相关的提交
git log --committer=Jack
- 仅显示指定关键字的提交
git log --grep=init
显示修改的文件
- 仅在提交信息后显示已修改的文件清单
git log --name-only
git log --name-only --oneline
- 显示新增、修改、删除的文件清单
git log --name-status
git log --name-status --oneline
显示日志统计信息
- 显示每次更新的文件修改统计信息，也显示更新的文件名和修改的多少。
git log --stat
git log --stat --oneline
- 只显示 --stat 中最后的行数修改添加的统计。不显示更新的文件名。
git log --shortstat
git log --shortstat --oneline
显示单次日志信息
git show [commit id]
git show [commit id] --name-only
git show [commit id] --name-only --oneline
git show [commit id] --name-status
git show [commit id] --stat
git show [commit id] --shortstat
查找某个字符串在何时添加
git log -S"string wanted to search" --oneline
将日志按照格式导出到文件中
git log --pretty=format:'%h was %an, %ar, message: %s' > log.log
以上只是简单介绍了一些 git log 命令支持的选项。表格还列出了一些其他常用的选项及其释义。
| 选项 | 说明 |
|---|---|
| -p | 按补丁格式显示每个更新之间的差异。 |
| --word-diff | 按 word diff 格式显示差异。 |
| --stat | 显示每次更新的文件修改统计信息。 |
| --shortstat | 只显示 --stat 中最后的行数修改添加移除统计。 |
| --name-only | 仅在提交信息后显示已修改的文件清单。 |
| --name-status | 显示新增、修改、删除的文件清单。 |
| --abbrev-commit | 仅显示 SHA-1 的前几个字符，而非所有的 40 个字符。 |
| --relative-date | 使用较短的相对时间显示（比如，“2 weeks ago”）。 |
| --graph | 显示 ASCII 图形表示的分支合并历史。 |
| --pretty | 使用其他格式显示历史提交信息。可用的选项包括 oneline，short，full，fuller 和 format（后跟指定格式）。 |
| --oneline | --pretty=oneline --abbrev-commit 的简化用法。 |
