命令:git log
2. 选项 --pretty[=<format>]
1)介绍
除了默认格式查看提交历史以外,还可以通过 --pretty[=<format>] 或者
--format[=<format>] 制定输出格式。<format> 可以是 noeline, short,
medium, full, fuller, email, raw, format: 中的一个,他们各自的输出格式可以参考 git log
--help 或者(3)。接下来我们主要是讨论 format: 的使用方法。
2)定制提交格式 --pretty=format:
--pretty=format:"format" 的用法就想 printf 的用法一样,只是换行从 \n 变为 %n 。下面列出一些常用的占位符,分别来自于(1)和(2),更详细请参考(3)或者 git log --help。
选项 说明
%H 提交对象(commit)的完整哈希字串
%h 提交对象的简短哈希字串
%T 树对象(tree)的完整哈希字串
%t 树对象的简短哈希字串
%P 父对象(parent)的完整哈希字串
%p 父对象的简短哈希字串
%an 作者(author)的名字
%_ae 作者的电子邮件地址 (由于新浪博客显示问题,请去除 %_ae 中的 _ )
%_ad 作者修订日期(可以用 -date= 选项定制格式)(由于新浪博客显示问题,请去除 % ad 中的 _ )
%ar 作者修订日期,按多久以前的方式显示
%cn 提交者(committer)的名字
%_ce 提交者的电子邮件地址(由于新浪博客显示问题,请去除 %_ce 中的 _ )
%_cd 提交日期 (由于新浪博客显示问题,请去除 %_cd 中的 _ )
%cr 提交日期,按多久以前的方式显示
%d: ref名称
%s: 提交的信息标题
%b: 提交的信息内容
%Cred: 切换到红色
%Cgreen: 切换到绿色
%_Cblue: 切换到蓝色 (由于新浪博客显示问题,请去除 %_Cblue 中的 _)
%Creset: 重设颜色
%C(...): 制定颜色, as described in color.branch.* config option
%n: 换行
注意:作者(author)_和_提交者(committer)_之间究竟有何差别,其实作者指的是实际作出修改的人,提交者指的是最后将此工作成果提交
到仓库的人。所以,当你为某个项目发布补丁,然后某个核心成员将你的补丁并入项目时,你就是作者,而那个核心成员就是提交者。引用来自(1)。
例如,我们只需要输出完成的哈希值以及提交的信息标题,就可以使用命令:
$git log --pretty=format:"%H %n %s"
38896a27dc8ab4f47883bd67d300f6145f0478b7
commit write 2
7d3e94cf22b17f7d097479ae8d9367e42509bb3f
Initial commit
3)定制专属于你的 log 格式
根据上面的说明,我们可以定制属于自己 log 格式:
$git
config --global alias.lg "log --graph --pretty=format:‘%Cred%H%Creset
@%C(yellow)%d%Creset %n Author: %cn <%_ce> %n Date: %_cd
%_Cblue(%cr)%Creset %n %n Commit subject: %Cgreen%s%Creset %n‘"
注:命令中 %_ce、%_cd、%_Cblue 分别去除其下划线 _ 。
$git lg
* 38896a27dc8ab4f47883bd67d300f6145f0478b7 @ (HEAD, master)
| Author: Eddy <[email protected]>
| Date: Thu Feb 2 17:06:06 2012 +0800 (8 days ago)
|
| Commit subject: commit write 2
|
* 7d3e94cf22b17f7d097479ae8d9367e42509bb3f @
Author: Eddy <[email protected]>
Date: Thu Feb 2 17:05:00 2012 +0800 (8 days ago)
Commit subject: Initial commit
4)其它选项
git log 支持的选项有很多,详细请参考 git log --help ,常用的有(引用(1)中的表2-2):
选项 说明
-p 按补丁格式显示每个更新之间的差异。
--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(后跟指定格式)。
参考资料:
(1) http://progit.org/book/zh/ch2-3.html
(2) http://ruby-china.org/topics/939
(3) http://linux.die.net/man/1/git-show