10. Git 项目历史
目的
学习如何查看项目的历史。
获得已经做过的更改清单是 git log
命令的功能。
$ git log
你应该看到:
$ git log
commit 1f7ec5eaa8f37c2770dae3b984c55a1531fcc9e7
Author: Jim Weirich <jim (at) neo.com>
Date: Sat Apr 13 15:20:42 2013 -0400
Added a comment
commit 582495ae59ca91bca156a3372a72f88f6261698b
Author: Jim Weirich <jim (at) neo.com>
Date: Sat Apr 13 15:20:42 2013 -0400
Added a default value
commit 323e28d99a07d404c04f27eb6e415d4b8ab1d615
Author: Jim Weirich <jim (at) neo.com>
Date: Sat Apr 13 15:20:42 2013 -0400
Using ARGV
commit 94164160adf8faa3119b409fcfcd13d0a0eb8020
Author: Jim Weirich <jim (at) neo.com>
Date: Sat Apr 13 15:20:42 2013 -0400
First Commit
这份清单是迄今为止我们对仓库所作的总共 4 次提交。
单行历史
你可以很好的控制处理 log
命令要精确显示的内容。我喜欢 单行格式:
$ git log --pretty=oneline
你应该看到:
$ git log --pretty=oneline
1f7ec5eaa8f37c2770dae3b984c55a1531fcc9e7 Added a comment
582495ae59ca91bca156a3372a72f88f6261698b Added a default value
323e28d99a07d404c04f27eb6e415d4b8ab1d615 Using ARGV
94164160adf8faa3119b409fcfcd13d0a0eb8020 First Commit
控制显示哪个条目
log
命令有许多选项用来选择显示哪个条目。玩玩下面的选 项:
$ git log --pretty=oneline --max-count=2
$ git log --pretty=oneline --since='5 minutes ago'
$ git log --pretty=oneline --until='5 minutes ago'
$ git log --pretty=oneline --author=<your name>
$ git log --pretty=oneline --all
参阅 man git-log
了解更多细节。
更加漂亮
这是我用来复查上周所做更改的命令。如果我只想看自己所 作的更改,那么我将添加--author=jim
。
$ git log --all --pretty=format:'%h %cd %s (%an)' --since='7 days ago'
终极日志格式
随着时间的推移,我发现在工作时最喜欢下列日志格式。
$ git log --pretty=format:'%h %ad | %s%d [%an]' --graph --date=short'
它看起来像这样:
$ git log --pretty=format:'%h %ad | %s%d [%an]' --graph --date=short
* 1f7ec5e 2013-04-13 | Added a comment (HEAD, master) [Jim Weirich]
* 582495a 2013-04-13 | Added a default value [Jim Weirich]
* 323e28d 2013-04-13 | Using ARGV [Jim Weirich]
* 9416416 2013-04-13 | First Commit [Jim Weirich]
让我们看一下细节:
--pretty="..."
定义输出的格式%h
是提交 hash 的缩写%d
是提交的装饰(如分支头或标签)%ad
是创作日期%s
是注释%an
是作者姓名--graph
使用 ASCII 图形布局显示提交树--date=short
保留日期格式更好且更短
其它工具
gitx (Mac) 和 gitk (任意平台) 在浏览日志历史时十分有用。