【Git学习】 如何通过git log命令来打印出在两个commit之间的所有不同的author提交的记录
一、需求描述
每次集成提测，都会有一大批的人员合并代码到develop分支，然后jenkins编译完成之后，得写提测记录。之前负责提测的人员都是直接复制jenkins的修改记录页面的文字。如下所示：
但是这个复制出来的文字会有个问题，就是显示出来的文字可能都不是全部的提交记录，比如下面这个第12条就没有显示完整。
必须点击details按钮，才能找到全部的提交信息。
因此，这个负责提测的人员可能每次写的提测记录都是词不达意，不知道写的什么玩意。导致测试人员可能每次也不知道到底测试什么。
因此我们的需求是：将上一次成功编译之后的jenkins任务和这一次成功编译的jenkins任务直接的变更记录都能够完完整整的显示出来，因此我决定写一个shell脚本来帮助这位同事。
二、熟悉 git log 命令
- 【官方地址】 https://git-scm.com/docs/git-log
- 【git log命令全解析，打log还能这么随心所欲！】 https://www.cnblogs.com/bellkosmos/p/5923439.html
主要是参考了上面的两篇文章，重新梳理了一下git log 命令的用法。
下面直接转载 博客园-阁刚广志，地址：http://www.cnblogs.com/bellkosmos/p/5923439.html 来复习下git log命令
git log用于查询版本的历史，命令形式如下：
git log [<options>] [<since>..<until>] [[--] <path>...]
这条命令有很多参数选项
2.1 一、不带参数
- 如果不带任何参数，它会列出所有历史记录，最近的排在最上方，显示提交对象的哈希值，作者、提交日期、和提交说明
- 如果记录过多，则按Page Up、Page Down、↓、↑来控制显示
- 按q退出历史记录列表
2.2 二、显示参数
2.2.1 -p
-p：按补丁显示每个更新间的差异，比下一条- -stat命令信息更全
2.2.2 --stat
--stat：显示每次更新的修改文件的统计信息，每个提交都列出了修改过的文件，以及其中添加和移除的行数，并在最后列出所有增减行数小计
2.2.3 --shortstat
--shortstat：只显示–stat中最后的行数添加修改删除统计
2.2.4 --name-only
--name-only：尽在已修改的提交信息后显示文件清单
2.2.5 --name-status
--name-status：显示新增、修改和删除的文件清单
2.2.6 --abbrev-commit
--abbrev-commit：仅显示SHA-1的前几个字符，而非所有的40个字符
2.2.7 --relative-date
--relative-date：使用较短的相对时间显示（例如：“two weeks ago”）
2.2.8 --graph
--graph：显示ASCII图形表示的分支合并历史
2.2.9 --pretty
--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(bold blue)<%an>
它的效果是：
先断句：
［%Cred%h］［%Creset -］［%C(yellow)%d ］［%Cblue%s］［%Cgreen(%cd)］［%C(bold blue)<%an>］然后就是很明显能得到的规律了
- 一个颜色＋一个内容
- 颜色以％C开头，后边接几种颜色，还可以设置字体，如果要设置字体的话，要一块加个括号
- 能设置的颜色值包括：reset（默认的灰色），normal, black, red, green, yellow, blue, magenta, cyan, white.
- 字体属性则有bold, dim, ul, blink, reverse.
- 内容可以是占位元字符，也可以是直接显示的普通字符
2.2.10 --date
--date= (relative|local|default|iso|rfc|short|raw)：定制后边如果出现%ad或%cd时的日期格式
有几个默认选项
1. --date=relative：shows dates relative to the current time, e.g. “2 hours ago”.
2. --date=local：shows timestamps in user’s local timezone.
3. --date=iso (or --date=iso8601)：shows timestamps in ISO 8601 format.
4. --date=rfc (or --date=rfc2822)：shows timestamps in RFC 2822 format,often found in E-mail messages.
5. --date=short：shows only date but not time, in YYYY-MM-DD format.这个挺好用
6. --date=raw：shows the date in the internal raw git format %s %z format.
7. --date=default：shows timestamps in the original timezone (either committer’s or author’s).也可以自定义格式（需要git版本2.6.0以上），比如–date=format:‘%Y-%m-%d %H:%M:%S’ 会格式化成：2016-01-13 11:32:13，其他的格式化占位符如下：
1. %a：Abbreviated weekday name
2. %A：Full weekday name
3. %b：Abbreviated month name
4. %B：Full month name
5. %c：Date and time representation appropriate for locale
6. %d：Day of month as decimal number (01 – 31)
7. %H： Hour in 24-hour format (00 – 23)
8. %I：Hour in 12-hour format (01 – 12)
9. %j：Day of year as decimal number (001 – 366)
10. %m：Month as decimal number (01 – 12)
11. %M：Minute as decimal number (00 – 59)
12. %p：Current locale’s A.M./P.M. indicator for 12-hour clock
13. %S：Second as decimal number (00 – 59)
14. %U：Week of year as decimal number, with Sunday as first day of week (00 – 53)
15. %w：Weekday as decimal number (0 – 6; Sunday is 0)
16. %W：Week of year as decimal number, with Monday as first day of week (00 – 53)
17. %x：Date representation for current locale
18. %X：Time representation for current locale
19. %y：Year without century, as decimal number (00 – 99)
20. %Y：Year with century, as decimal number
21. %z, %Z：Either the time-zone name or time zone abbreviation, depending on registry settings; no characters if time zone is unknown
22. %%：Percent sign
2.3 三、筛选参数：
- 按数量
- -n：显示前n条log
- 按日期
- –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是一个意思，都可以用
- –after=
- 按作者
- –author=
- 比如git log --author=“John"，显示John贡献的commit
- 注意：作者名不需要精确匹配，只需要包含就行了
- 而且：可以使用正则表达式，比如git log --author="John|Mary”，搜索Marry和John贡献的commit
- 而且：这个–author不仅包含名还包含email, 所以你可以用这个搜索email
- –author=
- 按commit描述
- –grep=
- 比如：git log --grep=“JRA-224”
- 而且：可以传入-i用来忽略大小写
- 注意：如果想同时使用–grep和–author，必须在附加一个–all-match参数
- –grep=
- 按文件
- -（空格）或［没有］
- 有时你可能只对某个文件的修改感兴趣, 你只想查看跟某个文件相关的历史信息, 你只需要插入你感兴趣文件的路径［对，是路径，所以经常是不太好用］就可以了
- 比如：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文件夹下所有文件的提交记录
- 按分支
- –branchName branchName为任意一个分支名字，查看某个分支上的提交记录
- 需要放到参数中的最后位置处
- 如果分支名与文件名相同，系统会提示错 误，可通过–选项来指定给定的参数是分支名还是文件名
- 比如：在当前分支中有一个名为v1的文件，同时还存在一个名为v1的分支
- git log v1 – 此时的v1代表的是分支名字（－－后边是空的）
- git log – v1 此时的v1代表的是名为v1的文件
- git log v1 －－ v1 代表v1分支下的v1文件
- 按内容
- -S"“、-G”"
1. 有时你想搜索和新增或删除某行代码相关的commit. 可以使用这条命令
2. 假设你想知道Hello, World!这句话是什么时候加入到项目里去的，可以用：git log -S"Hello,World!"
3. 另外：如果你想使用正则表达式去匹配而不是字符串, 那么你可以使用-G代替-S.
4. 这是一个非常有用的debug工具, 使用他你可以定位所有跟某行代码相关的commit. 甚至可以查看某行是什么时候被copy的, 什么时候移到另外一个文件中去的
5. 注：-S后没有"="，与查询内容之间也没有空格符
- -S"“、-G”"
- 按范围
- git log …
1. 这个命令可以查看某个范围的commit
2. 这个命令非常有用当你使用branch做为range参数的时候. 能很方便的显示2个branch之间的不同
3. 比如：git log master…feature，master…feature这个range包含了在feature有而在master没有的所有commit，同样，如果是feature…master包含所有master有但是feature没有的commit
4. 另外，如果是三个点，表示或的意思：git log master…test 查询master或test分支中的提交记录
- git log …
- 过滤掉merge commit
- –no-merges
1. 默认情况下git log会输出merge commit. 你可以通过–no-merges标记来过滤掉merge commit，git log --no-merges
2. 另外，如果你只对merge commit感兴趣可以使用—merges，git log --merges
- –no-merges
- 按标签tag
- git log v1.0
1. 直接这样是查询标签之前的commit
2. 加两个点git log v1.0… 查询从v1.0以后的提交历史记录(不包含v1.0)
- git log v1.0
- 按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代表倒数第二次提交
- 其中，commit可以是提交哈希值的简写模式，也可以使用HEAD代替
最后干货，你会喜欢的~
下面第一条的效果是这样：
git config --global alias.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(bold blue)<%an>%Creset' --abbrev-commit"git config --global alias.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(bold blue)<%an>%Creset' --abbrev-commit"git config --global alias.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(bold blue)<%an>%Creset' --abbrev-commit"git config --global alias.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(bold blue)<%an>%Creset' --abbrev-commit"
三、编写shell脚本
3.1 使用git log 命令 编写shell脚本
编写一个 show_git_log.sh 脚本，并将该脚本放到项目中，上传到gitlab中。
show_git_log.sh 脚本内容如下所示：
#!/bin/bash# 用于打印 两次 commit sha1 直接的提交记录，按照作者名称依次过滤打印出来，方便提测# 命令执行的时候 如： ./show_git_log.sh a383d2477351fab794981b6e79400bd0d8e99ddb
# 打印的结果为： 传递进来的参数为： ./show_git_log.sh a383d2477351fab794981b6e79400bd0d8e99ddb
# $0 为 ./show_git_log.sh
# $1 为 上一次成功编译的commit号
echo "传递进来的参数为： $0 $1"#commit 提交的作者数组,方便一次遍历
arr=("ouyangpeng" "user1" "user2" "user3" "user4" "user5" "user6" "user7" "user8" "user9" )
#循环使用git log命令 通过 author来过滤
for value in ${arr[@]}
do#git log --branches refs/remotes/origin/feature/DevelopGlobalXtc $1..HEAD --pretty=format:"%cn %s" --author=$value --no-merges#git log --branches refs/remotes/origin/$2 $1..HEAD --pretty=format:"%cn %s" --author=$value --no-mergesgit log $1..HEAD --pretty=format:"%cn %s" --author=$value --no-mergesecho "\n"
done
如上所示，我们将成员小组的全部人员，放在了一个数组里面，然后循环执行git log命令并通过 author来过滤。我们使用了
git log commit1 .. commit2：查询commit1与commit2之间的记录，包括commit1和commit2.
其中 HEAD 是最新的commit信息。
3.2 配置jenkins
3.2.1 添加一个参数化构建过程
- 在jenkins的具体job中，在【参数化构建过程】中，添加一下参数，类型为【String Parameter】
2. 设置具体的参数内容
- 名字：设置为 LAST_SUCCESS_BUILD_GIT_COMMIT
- 默认值： 不设置
- 描述： 上一次编译成功的git commi值
3.2.2 在构建中使用这个参数
在jenkins的job配置中，【构建】中添加一个【添加构建步骤】，类型宣威【Execute shell】，如下所示：
由于我原本就有了，所以在原来的基础上添加上新的shell脚本即可，如下所示
新添加的shell脚本内容如下：其中${LAST_SUCCESS_BUILD_GIT_COMMIT}是刚刚定义的动态化参数。
# 打印git log 记录
chmod 777 ./show_git_log.sh
./show_git_log.sh ${LAST_SUCCESS_BUILD_GIT_COMMIT}
3.3 执行jenkins任务
如上图所示，点击【Build with Parameters】执行jenkins任务，在【LAST_SUCCESS_BUILD_GIT_COMMIT】这个参数中，填写好上一次成功编译的git commit sha1 值。
如上所示，第18次成功编译的 git Revision为 : a383d2477351fab794981b6e79400bd0d8e99ddb
将该版本号信息填入之后，点击【开始构建】
jenkins job执行最后调用刚刚的shell脚本，如下所示，将两次git commit 之间的提交记录都打印出来了。
查看下第19次的jenkins的change，如下所示
可以发现和上面执行shell脚本打印出来的一样。
现在同步下主干代码，然后开启第20次编译。
编译完成之后，jenkins的打印结果如下
对比下jenkins自己打印出来的 修改记录。
没问题，但是我们打印出来的 通过不同作者已经归纳到一个地方，方便提测。
之前那位提测的同学，每次整理这些日志 至少十分钟，现在 直接复制粘贴即可，几秒钟搞定了。
四、使用git shortlog命令
- 【官方介绍地址】 https://git-scm.com/docs/git-shortlog
git shortlog是一个特殊版本的git log, 他的目的是为了创建一个发布的通知. 将commit按照作者分组, 显示每个commit的第一行描述. 通过他你很容易看到谁做了些什么.
因此我们使用git shortlog命令来重新实现刚才的代码，更加简洁明了，而且也不需要维护一份提交者的数组了，如下所示
4.1 使用git shotlog命令重写show_git_log.sh脚本
show_git_log.sh 的源代码如下所示：
#!/bin/bash# 用于打印 两次 commit sha1 直接的提交记录，按照作者名称依次过滤打印出来，方便提测# 命令执行的时候 如： ./show_git_log.sh a383d2477351fab794981b6e79400bd0d8e99ddb
# 打印的结果为： 传递进来的参数为： ./show_git_log.sh a383d2477351fab794981b6e79400bd0d8e99ddb
# $0 为 ./show_git_log.sh
# $1 为 上一次成功编译的commit号
echo "传递进来的参数为： $0 $1"git shortlog $1..HEAD --pretty=format:"%cn %s" --no-merges
在git bash 界面 执行命令，如下所示，直接只能分好了组，比我自己实现的好多了。
$ ./show_git_log.sh a383d2477351fab794981b6e79400bd0d8e99ddb
4.2 jenkins执行看效果
将第20次的版本号 6121536bb9883b9dc1eb877426e53c1d0f5adf3e 填入，开始构建
编译完成之后，打印出来的日志如下所示：
第21次编译，jenkins显示的修改记录如下。
对比一下，明显我打印出来的更加美观，完美！分好了小组，每个不同的author分为一组，清晰明了。
参考链接
- https://git-scm.com/docs/git-log
- https://git-scm.com/docs/git-shortlog
- http://www.cnblogs.com/bellkosmos/p/5923439.html
- http://www.cnblogs.com/irocker/p/advanced-git-log.html
作者：欧阳鹏 欢迎转载，与人分享是进步的源泉！
转载请保留原文地址：https://ouyangpeng.blog.csdn.net/article/details/88685202
☞ 本人QQ: 3024665621
☞ QQ交流群: 123133153
☞ github.com/ouyangpeng
☞ oypcz@foxmail.com
【Git学习】 如何通过git log命令来打印出在两个commit之间的所有不同的author提交的记录相关推荐
- Git学习系列之Git基本操作提交项目（图文详解）
前面博客 Git学习系列之Git基本操作克隆项目(图文详解) 然后可以 cd 切换到 LispGentleIntro 目录, 新增或者修改某些文件.这里只是模拟一下操作, 实际情况可能是 使用 Ecl ...
- Git学习5：Git常用命令简明用法
不要使用git commit -a 该命令可以对本地所有的变更文件(包括对本地修改和删除的文件)执行提交操作,但是不包括未被版本库跟踪的文件. git命令补充说明 显示.git目录所在的位置 git ...
- 【Git学习】使用git reflog 命令来查看历史提交记录并使用提交记录恢复已经被删除掉的分支
一.问题描述 昨天下午有个同事急急忙忙跑我座位上,要我帮忙,说他刚刚因为手误,将他本地的某个project的某个branch分支删除了,并且也将Gitlab上面的远程分支也删除了.他本来是想发起mer ...
- 进厂手册：Git 学习笔记（详解命令）
文章目录 git 对象 通过git对象进行文件的保存 git对象的缺点 树对象 构建树对象 提交对象 高层命令 工作区的文件状态 git reset hard 咋用以及用错了怎么恢复 git chec ...
- git学习(二)：git config命令
不同的git config操作不同的参数文件 1 git config --global // 配置用户目录下的.gitconfig那文件 2 git config --system // 配置系统级 ...
- 【git学习四】git基础之git为项目打标签
1.背景 今天学习了下如何给项目打标签,为此项目的修改标记版本号,然后可以直接推送版本号到服务器上,方便了很多,而且便于对项目进行管理. 2.打标签 1.查询已有标签,可以使用git tag命令,查询 ...
- 【git学习二】git基础之git管理本地项目
1.背景 git基础打算分两部分来说,一部分是对于本地项目的管理,第二部分是对于远程代码仓库的操作.git执行本地项目管理包括对于相关文件的追踪,暂存区的比较分析,提交,撤销等功能. 2.本地项目管理 ...
- Git学习笔记：Git简介
前言 在补习python的时候主要参考的是廖雪峰的教程Python教程,在学习完后准备完成期末作业时,遇到了一个技术难题,需要初步掌握git,因此开始了git的学习. 本教程参考廖雪峰的Git教程 目 ...
- mzy git学习，初识git（一）
GIT学习 git工作区.暂存区.本地库.远程库 工作区:实际上我们工作的地方,进行写代码或者文件的地方. 暂存区:我们执行了git add 操作之后,就会被提交到暂存区. 本地库:其实最后我们需要执 ...
最新文章
- c4d教程-太空火车站场景创作视频教程Skillshare – Create A Space Train Scene With Cinema 4D Redshift Render
- 一个智能机器人的语录
- Json字符串解析原理、超大json对象的解析
- xps文档节点序列化，节点排序
- C语言变量的定义包括变量存储类型和变量的什么？
- 生产上完成TopN统计流程
- Linux中MongoDB的安装
- C语言深度剖析-----数组基础
- uni-app url 传参有长度限制么？
- 射频识别技术漫谈(17)——射频卡中数据的存储形式
- typescript入门练手小demo
- 计算机科班Java开发好书推荐
- 刘彬20000词汇10
- 程序员Linux命令常用大全
- 对标测评YD云电脑和天翼云电脑公众版
- 阿里妈妈：品牌广告中的NLP算法实践
- TimerTask.cancel() 与 Timer.cancel() 的区别
- 英语语法汇总（6.副词）
- android 腾讯广告联盟,Android腾讯广告联盟接入-----开屏广告
- 公司项目要用到的组件