gitlog命令全解析,打log还能这么随心所欲!
gitlog命令非常强大而好用,在复杂系统的版本管理中扮演着重要的角色,但默认的gitlog命令显示出的东西实在太丑,不好好打扮一下根本没法见人,打扮好了用alias命令拍个照片,就正式出道了!
下面先详细而系统地介绍gitlog的所有配置知识(用我一向简洁清晰的表述方式),熟悉了这些东西,你就可以自由配置自己美丽的gitlog了~
最后上个干货,直接给一个我打扮好的alias配置,懒人直接跳到最后吧!
(转载请注明:博客园-阁刚广志,地址:http://www.cnblogs.com/bellkosmos/p/5923439.html)
gitlog用于查询版本的历史,命令形式如下:
gitlog[][..][[--]...]
这条命令有很多参数选项
一、不带参数
如果不带任何参数,它会列出所有历史记录,最近的排在最上方,显示提交对象的哈希值,作者、提交日期、和提交说明
如果记录过多,则按PageUp、PageDown、↓、↑来控制显示
按q退出历史记录列表
二、显示参数
-p:按补丁显示每个更新间的差异,比下一条--stat命令信息更全
--stat:显示每次更新的修改文件的统计信息,每个提交都列出了修改过的文件,以及其中添加和移除的行数,并在最后列出所有增减行数小计
--shortstat:只显示--stat中最后的行数添加修改删除统计
--name-only:尽在已修改的提交信息后显示文件清单
--name-status:显示新增、修改和删除的文件清单
--abbrev-commit:仅显示SHA-1的前几个字符,而非所有的40个字符
--relative-date:使用较短的相对时间显示(例如:"twoweeksago")
--graph:显示ASCII图形表示的分支合并历史
—pretty=:使用其他格式显示历史提交信息,可选项有:oneline,short,medium,full,fuller,email,raw以及format:,默认为medium,如:
--pretty=oneline:一行显示,只显示哈希值和提交说明(--online本身也可以作为单独的属性)
--pretty=format:”":控制显示的记录格式,如:
%H提交对象(commit)的完整哈希字串
%h提交对象的简短哈希字串
%T树对象(tree)的完整哈希字串
%t树对象的简短哈希字串
%P父对象(parent)的完整哈希字串
%p父对象的简短哈希字串
%an作者(author)的名字
%ae作者的电子邮件地址
%ad作者修订日期(可以用-date=选项定制格式)
%ar作者修订日期,按多久以前的方式显示
%cn提交者(committer)的名字
作者和提交者的区别不知道是啥?
作者与提交者的关系:作者是程序的修改者,提交者是代码提交人(自己的修改不提交是怎么能让别人拉下来再提交的?)
其实作者指的是实际作出修改的人,提交者指的是最后将此工作成果提交到仓库的人。所以,当你为某个项目发布补丁,然后某个核心成员将你的补丁并入项目时,你就是作者,而那个核心成员就是提交者(soga)
%ce提交者的电子邮件地址
%cd提交日期(可以用-date=选项定制格式)
%cr提交日期,按多久以前的方式显示
%s提交说明
带颜色的--pretty=format:”",这个另外写出来分析
以这句为例:%Cred%h%Creset-%C(yellow)%d%Cblue%s%Cgreen(%cd)%C(boldblue)<%an>
它的效果是:
先断句:[%Cred%h][%Creset-][%C(yellow)%d][%Cblue%s][%Cgreen(%cd)][%C(boldblue)<%an>]
然后就是很明显能得到的规律了
一个颜色+一个内容
颜色以%C开头,后边接几种颜色,还可以设置字体,如果要设置字体的话,要一块加个括号
能设置的颜色值包括:reset(默认的灰色),normal,black,red,green,yellow,blue,magenta,cyan,white.
字体属性则有bold,dim,ul,blink,reverse.
内容可以是占位元字符,也可以是直接显示的普通字符
--date=(relative|local|default|iso|rfc|short|raw):定制后边如果出现%ad或%cd时的日期格式
有几个默认选项
--date=relative:showsdatesrelativetothecurrenttime,e.g."2hoursago".
--date=local:showstimestampsinuser’slocaltimezone.
--date=iso(or--date=iso8601):showstimestampsinISO8601format.
--date=rfc(or--date=rfc2822):showstimestampsinRFC2822format,oftenfoundinE-mailmessages.
--date=short:showsonlydatebutnottime,inYYYY-MM-DDformat.这个挺好用
--date=raw:showsthedateintheinternalrawgitformat%s%zformat.
--date=default:showstimestampsintheoriginaltimezone(eithercommitter’sorauthor’s).
也可以自定义格式(需要git版本2.6.0以上),比如--date=format:''%Y-%m-%d%H:%M:%S''会格式化成:2016-01-1311:32:13,其他的格式化占位符如下:
%a:Abbreviatedweekdayname
%A:Fullweekdayname
%b:Abbreviatedmonthname
%B:Fullmonthname
%c:Dateandtimerepresentationappropriateforlocale
%d:Dayofmonthasdecimalnumber(01–31)
%H:Hourin24-hourformat(00–23)
%I:Hourin12-hourformat(01–12)
%j:Dayofyearasdecimalnumber(001–366)
%m:Monthasdecimalnumber(01–12)
%M:Minuteasdecimalnumber(00–59)
%p:Currentlocale''sA.M./P.M.indicatorfor12-hourclock
%S:Secondasdecimalnumber(00–59)
%U:Weekofyearasdecimalnumber,withSundayasfirstdayofweek(00–53)
%w:Weekdayasdecimalnumber(0–6;Sundayis0)
%W:Weekofyearasdecimalnumber,withMondayasfirstdayofweek(00–53)
%x:Daterepresentationforcurrentlocale
%X:Timerepresentationforcurrentlocale
%y:Yearwithoutcentury,asdecimalnumber(00–99)
%Y:Yearwithcentury,asdecimalnumber
%z,%Z:Eitherthetime-zonenameortimezoneabbreviation,dependingonregistrysettings;nocharactersiftimezoneisunknown
%%:Percentsign
三、筛选参数:
按数量
-n:显示前n条log
按日期
--after=
比如gitlog--after="2014-7-1”,显示2014年7月1号之后的commit(包含7月1号)
后边的日期还可以用相对时间表示,比如"1weekago"和”yesterday",比如gitlog--after="yesterday"
这里的格式可以是什么?
--before=
同上
另外这两条命令可以同时使用表示时间段,比如gitlog--after="2014-7-1"--before="2014-7-4"
另外--since--until和--after--before是一个意思,都可以用
按作者
--author=
比如gitlog--author=“John",显示John贡献的commit
注意:作者名不需要精确匹配,只需要包含就行了
而且:可以使用正则表达式,比如gitlog--author="John\|Mary”,搜索Marry和John贡献的commit
而且:这个--author不仅包含名还包含email,所以你可以用这个搜索email
按commit描述
--grep=
比如:gitlog--grep="JRA-224"
而且:可以传入-i用来忽略大小写
注意:如果想同时使用--grep和--author,必须在附加一个--all-match参数
按文件
--(空格)或[没有]
有时你可能只对某个文件的修改感兴趣,你只想查看跟某个文件相关的历史信息,你只需要插入你感兴趣文件的路径[对,是路径,所以经常是不太好用]就可以了
比如:gitlog--foo.pybar.py,只返回和foo.py或bar.py相关的commit
这里的--是告诉Git后面的参数是文件路径而不是branch的名字.如果后面的文件路径不会和某个branch产生混淆,你可以省略--,比如gitlogfoo.py
另外,后边的路径还支持正则,比如:gitloginstall.md是,指定项目路径下的所有以install.md结尾的文件的提交历史
另外,文件名应该放到参数的最后位置,通常在前面加上--并用空格隔开表示是文件
另外,gitlogfile/查看file文件夹下所有文件的提交记录
按分支
--
--branchNamebranchName为任意一个分支名字,查看某个分支上的提交记录
需要放到参数中的最后位置处
如果分支名与文件名相同,系统会提示错误,可通过--选项来指定给定的参数是分支名还是文件名
比如:在当前分支中有一个名为v1的文件,同时还存在一个名为v1的分支
gitlogv1--此时的v1代表的是分支名字(--后边是空的)
gitlog--v1此时的v1代表的是名为v1的文件
gitlogv1--v1代表v1分支下的v1文件
按内容
-S""、-G""
有时你想搜索和新增或删除某行代码相关的commit.可以使用这条命令
假设你想知道Hello,World!这句话是什么时候加入到项目里去的,可以用:gitlog-S"Hello,World!"
另外:如果你想使用正则表达式去匹配而不是字符串,那么你可以使用-G代替-S.
这是一个非常有用的debug工具,使用他你可以定位所有跟某行代码相关的commit.甚至可以查看某行是什么时候被copy的,什么时候移到另外一个文件中去的
注:-S后没有"=",与查询内容之间也没有空格符
按范围
gitlog..
这个命令可以查看某个范围的commit
这个命令非常有用当你使用branch做为range参数的时候.能很方便的显示2个branch之间的不同
比如:gitlogmaster..feature,master..feature这个range包含了在feature有而在master没有的所有commit,同样,如果是feature..master包含所有master有但是feature没有的commit
另外,如果是三个点,表示或的意思:gitlogmaster...test查询master或test分支中的提交记录
过滤掉mergecommit
--no-merges
默认情况下gitlog会输出mergecommit.你可以通过--no-merges标记来过滤掉mergecommit,gitlog--no-merges
另外,如果你只对mergecommit感兴趣可以使用—merges,gitlog--merges
按标签tag
gitlogv1.0
直接这样是查询标签之前的commit
加两个点gitlogv1.0..查询从v1.0以后的提交历史记录(不包含v1.0)
按commit
gitlogcommit:查询commit之前的记录,包含commit
gitlogcommit1commit2:查询commit1与commit2之间的记录,包括commit1和commit2
gitlogcommit1..commit2:同上,但是不包括commit1
其中,commit可以是提交哈希值的简写模式,也可以使用HEAD代替
HEAD代表最后一次提交,HEAD^为最后一个提交的父提交,等同于HEAD~1
HEAD~2代表倒数第二次提交
最后干货
复制代码
gitconfig--globalalias.lm"log--no-merges--color--date=format:''%Y-%m-%d%H:%M:%S''--author=''你的名字!自己修改!''--pretty=format:''%Cred%h%Creset-%C(yellow)%d%Cblue%s%Cgreen(%cd)%C(boldblue)<%an>%www.tt951.comCreset''--abbrev-commit"
gitconfig--globalalias.lms"log--no-merges--color--stat--date=format:''%Y-%m-%d%H:%M:%S''--author=''你的名字!自己修改!''--pretty=format:''%Cred%h%Creset-%C(yellow)%d%Cblue%s%Cgreen(%cd)%C(boldblue)<%an>%Creset''--abbrev-commit"
gitconfig--globalalias.ls"log--no-merges--color--graph--date=format:''%Y-%m-%d%H:%M:%S''--pretty=format:''%Cred%h%Creset-%C(yellow)%d%Cblue%s%Cgreen(%cd)%C(boldblue)<%an>%Creset''--abbrev-commit"
gitconfig--globalalias.lss"log--no-merges--color--stat--graph--date=format:''%Y-%m-%d%H:%M:%S''--pretty=format:''%Cred%h%Creset-%C(yellow)%d%Cblue%s%Cgreen(%cd)%C(boldblue)<%an>%Creset''--abbrev-commit"
|
|