git log
命令主要用于查看Git版本演变历史(也就是提交历史),同时根据追加的参数和选项不同,也会有不同的展示效果。
但默认git log
命令显示出的x效果实在太丑,不好好打扮一下根本没法见人,打扮好了用alias
命令拍个照片,就正式出道了!
1、git log
命令说明
git log
用于查询版本的历史,命令形式如下:
git log [<options>] [<since>..<until>] [[--] <path>...]
默认的git log
命令显示效果如下:
(之前文件详细说明过了,这里简单说一下,主要说明git log
命令的参数)
2、git log
命令参数
这条命令有很多参数选项,下面详细的说明:
(1)不带参数
- 如果不带任何参数,它会列出所有历史记录,最近的排在最上方,显示提交对象的哈希值,作者、提交日期、和提交说明。
- 如果记录过多,则按
上下键
,Enter
(向下显示一行),空格
(显示下一页),来控制显示。 - 按
q
键退出历史记录列表。
(2)常用显示参数
-p
:按补丁格式显示每个更新的差异,比下一条--stat
命令信息更全。--stat
:显示每次提交修改文件的统计信息,每个提交都列出了修改过的文件,以及其中添加和移除的行数,并在最后列出所有增减行数小计。--shortstat
:只显示--stat
中最后的行数添加、修改、删除的统计。--name-only
:仅在提交信息后,显示已修改的文件清单。--name-status
:显示新增、修改、删除的文件清单。--abbrev-commit
:仅显示SHA-1
校验和的前几个字符,而非所有的40个字符。--relative-date
:使用较短的相对时间,而不是完整格式显示日期(比如“2 weeks ago”
)。--graph
:在日志旁以ASCII
图形显示分支与合并历史。--online
:列表的形式查看历史版本记录,--pretty=oneline --abbrev-commit
合用的简写。--pretty
:使用其他格式显示历史提交信息。可用的选项包括oneline
、short
、full
、fuller
和format
(用来定义自己的格式)。
(3)--pretty
参数
--pretty
:自定义格式化显示历史提交信息。
选项有:
1)--pretty=oneline
:一行显示,只显示哈希值和提交说明(--online
本身也可以作为单独的属性)。
2)--pretty=format:” "
:控制显示信息的格式。
序号 | 格式 | 说明 |
---|---|---|
1 | %H |
提交的完整哈希值(commit-id )。 |
2 | %h |
提交的简写哈希值。 |
3 | %T |
树的完整哈希值(tree )。 |
4 | %t |
树的简写哈希值。 |
5 | %P |
父提交(parent )的完整哈希值。 |
6 | %p |
父提交的简写哈希值。 |
7 | %an |
作者名字(author )。 |
8 | %ae |
作者的电子邮件地址。 |
9 | %ad |
作者修订日期(可以用 --date= 选项 来定制格式)。 |
10 | %ar |
作者修订日期,按多久以前的方式显示。 |
11 | %cn |
提交者的名字(committer )。 |
12 | %ce |
提交者的电子邮件地址。 |
13 | %cd |
提交日期(可以用 --date= 选项 来定制格式)。 |
14 | %cr |
提交日期,按多久以前的方式显示。 |
15 | %s |
提交说明。 |
3)--pretty=format:” "
:控制显示信息的颜色。
- 颜色格式:
%Cred:将颜色切换为红色。
%Cgreen:将颜色切换为绿色。
%Cblue:将颜色切换为蓝色。
%Creset:空格。 - 举例:
执行命令:git log --color --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %C(cyan)%s %C(magenta)(%cr) %C(bold blue)<%an>%Creset'
两种效果如下:
- 我们先进行断句分析:
[%Cred%h][%Creset -][%C(yellow)%d ][%Cblue%s][%Cgreen(%cd)][%C(bold blue)<%an>]
然后就是很明显能得到的规律了:- 写法:一个颜色+一个内容,例如
%Cred%h
,依次排写。 - 颜色以
%C
开头,后边接几种颜色,还可以设置字体,如果要设置字体的话,要一块加个括号。
能设置的颜色值包括:reset
(默认的灰色),normal
,black
,red
,green
,yellow
,blue
,magenta
,cyan
,white
。(不能单独使用就加括号)
字体属性则有bold
,dim
,ul
,blink
,reverse
。 - 内容可以是占位元字符,也可以是直接显示的普通字符(例如上面的
-
)。
- 写法:一个颜色+一个内容,例如
(4)--date=
参数
--date=(relative|local|default|iso|rfc|short|raw)
仅对以人类可读格式显示的日期生效,例如使用--pretty.log.date
这个config
变量设置日志的默认值。
--date
有几个默认选项:
--date=relative
:显示相对于当前时间的日期,例如”2小时前”。--date=local
:显示用户本地时区中的时间戳。--date=iso
或--date=iso8601
:以ISO 8601
格式显示时间戳。--date=rfc
或--date=rfc2822
:以RFC 2822
格式显示时间戳,通常在电子邮件中找到。--date=short
:仅以YYYY-MM-DD
格式显示日期,而不显示时间。--date=raw
:以内部原始Git格式%s %z
格式显示日期。--date=default
:显示原始时区(提交者或作者)的时间戳。
也可以自定义格式(需要Git版本2.6.0以上):
比如:--date=format:'%Y-%m-%d %H:%M:%S'
,会格式化成:2016-01-13 11:32:13
。
其他的格式化占位符如下:
%a
:星期的缩写。%A
:星期的全名。%b
:月份的缩写。%B
:月份的全称。%c
:适用于区域设置的日期和时间表示。%d
:月中的天作为十进制数字(01 – 31)。%H
: 24小时制的小时(00 – 23)。%I
:2小时格式的小时(01 – 12)。%j
:一年中的天作为十进制数字(001 – 366)。%m
:以十进制数字表示的月份(01 – 12)。%M
:分钟以十进制数字表示(00 – 59)。%p
:当前语言环境的”上午/下午”,12小时制的指示器。%S
:秒作为十进制数字(00 – 59)。%U
:一年中的周为十进制数字,周日为一周的第一天(00 – 53)。%w
:工作日为十进制数字(0 – 6;星期日为0)。%W
:一年中的星期作为十进制数字,星期一作为星期的第一天(00 – 53)%x
:当前语言环境的日期表示。%X
:当前语言环境的时间表示。%y
:无世纪的年份,为十进制数字(00 – 99),也就是年份没有前两位。%Y
:带世纪的年份,以十进制数表示。%z
,%Z
:时区名称或时区缩写,取决于注册表设置; 如果时区未知,则没有字符。%%
:表示百分号。
(5)筛选参数
1)按数量
-n
:显示前n条提交信息。
2)按日期
--after=
比如git log --after="2014-7-1”
,显示2014年7月1号之后的commit
(包含7月1号)。
后边的日期还可以用相对时间表示,比如"1 week ago"
和”yesterday"
,比如git log --after="yesterday"
。--before=
:同上。
另外这两条命令可以同时使用表示时间段,比如git log --after="2014-7-1" --before="2014-7-4"
同理:--since
、--until
和--after
、--before
是一个意思。
--since
, --after
:仅显示指定时间之后的提交。
--until
, --before
:仅显示指定时间之前的提交。
3)按作者和提交者
--author=
:仅显示作者匹配指定字符串的提交。
- 比如
git log --author=“John"
,显示John
贡献的commit
。 - 注意:作者名不需要精确匹配,只需要包含就行了。
- 而且可以使用正则表达式,比如
git log --author="John|Mary”
,搜索Marry
和John
贡献的commit
。 - 而且这个
--author
不仅包含作者名,还包含作者的email
,所以你可以用这个搜索email
。
--committer
:仅显示提交者匹配指定字符串的提交。
4)按commit描述
--grep=
:仅显示提交说明中包含指定字符串的提交。
- 比如:
git log --grep="JRA-224"
- 而且可以传入
-i
用来忽略大小写。 - 注意:如果想同时使用
--grep
和--author
,必须在附加一个--all-match
参数。
5)按文件
--(空格)文件
或--[后边没有文件]
- 有时你可能只对某个文件的修改感兴趣,或你只想查看跟某个文件相关的历史信息,你只需要插入你感兴趣文件的路径,[对,是路径,所以经常是不太好用]就可以了。
- 比如:
git log -- foo.py bar.py
,只返回和foo.py
文件或bar.py
文件的相关commit
。 - 这里的
--
是告诉Git,后面的参数是文件路径而不是branch
(分支)的名字。 如果后面的文件路径不会和某个branch
产生混淆,你可以省略--
,比如git log foo.py
。 - 另外,后边的路径还支持正则,比如:
git log *install.md
,是指定项目路径下的所有以install.md
结尾文件的提交历史。 - 另外,文件名应该放到参数的最后位置,通常在前面加上
--
并用空格隔开表示是文件。 - 另外,
git log file/
,可以查看file
文件夹下所有文件的提交记录。
6)按分支
--
:
--branchName branchName
参数:为任意一个分支名字,查看某个分支上的提交记录。- 需要放到参数中的最后位置处。
- 如果分支名与文件名相同,系统会提示错误,可通过
--
选项,来指定给定的参数,是分支名还是文件名。
比如:在当前分支中有一个名为v1的文件,同时还存在一个名为v1的分支。如下:
git log v1 --
,此时的v1代表的是分支名字(--
后边是空的)。
git log -- v1
,此时的v1代表的是名为v1的文件。
git log v1 -- v1
:代表v1分支下的v1文件。
7)按内容
-S"<string>"
、-G"<string>"
:仅显示添加或删除内容匹配指定字符串的提交。
- 有时你想搜索,新增或删除某行代码相关的
commit
. 可以使用这条命令。 - 假设你想知道
Hello,World!
这句话,是什么时候加入到项目里去的,可以用:git log -S"Hello,World!"
。 - 另外,如果你想使用正则表达式去匹配,而不是字符串,那么你可以使用
-G
代替-S
。 - 这是一个非常有用的
debug
工具,使用他可以定位所有跟某行代码相关的commit
,甚至可以查看某行是什么时候被copy
的,什么时候移到另外一个文件中去的。 - 注意:
-S
后没有"="
,与查询内容之间也没有空格符。
8)按范围
git log <since>..<until>
:
- 这个命令可以查看某个范围的
commit
。 - 这个命令非常有用当你使用
branch
做为range
参数的时候. 能很方便的显示2个branch
(分支)之间的不同。 - 比如:
git log master..feature
,master..feature
这个range
(范围),包含了在feature
分支存在,而在master
分支没有的所有commit
。同样,如果是feature..master
,意思是包含所有master
分支有,但是feature
分支没有的commit
。 - 另外,如果是三个点,表示或的意思:
git log master...test
,意思是查询master
或test
分支中的提交记录。
9)过滤掉merge commit
--no-merges
:
- 默认情况下
git log
会输出merge commit
(合并提交)。你可以通过--no-merges
标记来过滤掉merge commit
,例如:git log --no-merges
。 - 另外,如果你只对
merge commit
感兴趣可以使用--merges
参数,例如:git log --merges
。
10)按标签tag
git log v1.0
:
- 直接这样是查询标签之前的
commit
。 - 加两个点,例如:
git log v1.0..
,是查询从v1.0
以后的提交历史记录(不包含v1.0)。
11)按commit
git log commit
:查询commit
之前的记录,包含commit
。git log commit1 commit2
:查询commit1
与commit2
之间的记录,包括commit1
和commit2
。git log commit1..commit2
:同上,但是不包括commit1
。
说明:
- 其中,
commit
可以是提交哈希值的简写模式,也可以使用HEAD代替。 - HEAD代表最后一次提交,
HEAD^
为最后一个提交的父提交,等同于HEAD~1
。 HEAD~2
代表倒数第二次提交。
提示:Git的指令是非常丰富的,通过
git help log
或者git help --web log
,可以以浏览器的方式查看更多关于log
的指令。
参考: