目的

学习如何查看项目的历史。

获得已经做过的更改清单是 git log 命令的功能。

  1. $ git log

你应该看到：

  1. $ git log
  2. commit 1f7ec5eaa8f37c2770dae3b984c55a1531fcc9e7
  3. Author: Jim Weirich <jim (at) neo.com>
  4. Date:   Sat Apr 13 15:20:42 2013 -0400
  6.     Added a comment
  8. commit 582495ae59ca91bca156a3372a72f88f6261698b
  9. Author: Jim Weirich <jim (at) neo.com>
  10. Date:   Sat Apr 13 15:20:42 2013 -0400
  12.     Added a default value
  14. commit 323e28d99a07d404c04f27eb6e415d4b8ab1d615
  15. Author: Jim Weirich <jim (at) neo.com>
  16. Date:   Sat Apr 13 15:20:42 2013 -0400
  18.     Using ARGV
  20. commit 94164160adf8faa3119b409fcfcd13d0a0eb8020
  21. Author: Jim Weirich <jim (at) neo.com>
  22. Date:   Sat Apr 13 15:20:42 2013 -0400
  24.     First Commit

这份清单是迄今为止我们对仓库所作的总共 4 次提交。

单行历史

你可以很好的控制处理 log 命令要精确显示的内容。我喜欢 单行格式：

  1. $ git log --pretty=oneline

你应该看到：

  1. $ git log --pretty=oneline
  2. 1f7ec5eaa8f37c2770dae3b984c55a1531fcc9e7 Added a comment
  3. 582495ae59ca91bca156a3372a72f88f6261698b Added a default value
  4. 323e28d99a07d404c04f27eb6e415d4b8ab1d615 Using ARGV
  5. 94164160adf8faa3119b409fcfcd13d0a0eb8020 First Commit

控制显示哪个条目

log 命令有许多选项用来选择显示哪个条目。玩玩下面的选 项：

  1. $ git log --pretty=oneline --max-count=2
  2. $ git log --pretty=oneline --since='5 minutes ago'
  3. $ git log --pretty=oneline --until='5 minutes ago'
  4. $ git log --pretty=oneline --author=<your name>
  5. $ git log --pretty=oneline --all

参阅 man git-log 了解更多细节。

更加漂亮

这是我用来复查上周所做更改的命令。如果我只想看自己所 作的更改，那么我将添加--author=jim。

  1. $ git log --all --pretty=format:'%h %cd %s (%an)' --since='7 days ago'

终极日志格式

随着时间的推移，我发现在工作时最喜欢下列日志格式。

  1. $ git log --pretty=format:'%h %ad | %s%d [%an]' --graph --date=short'

它看起来像这样：

  1. $ git log --pretty=format:'%h %ad | %s%d [%an]' --graph --date=short
  2. * 1f7ec5e 2013-04-13 | Added a comment (HEAD, master) [Jim Weirich]
  3. * 582495a 2013-04-13 | Added a default value [Jim Weirich]
  4. * 323e28d 2013-04-13 | Using ARGV [Jim Weirich]
  5. * 9416416 2013-04-13 | First Commit [Jim Weirich]

让我们看一下细节：

  • --pretty="..." 定义输出的格式
  • %h 是提交 hash 的缩写
  • %d 是提交的装饰（如分支头或标签）
  • %ad 是创作日期
  • %s 是注释
  • %an 是作者姓名
  • --graph 使用 ASCII 图形布局显示提交树
  • --date=short 保留日期格式更好且更短

其它工具

gitx (Mac) 和 gitk (任意平台) 在浏览日志历史时十分有用。