title: Git-叹为观止的 log 命令 & 其参数
date: 2018-03-18 12:12:01
tags:

log 这参数啊，真是的是太丰富了。

至于有多少，娃子们可以去 git-log 官方文档 去看下，太多了，我真的截不出来它们的风采。

官方君也知道太多了，也是非常贴心地按功能给分好了类：

• Commit Limiting（过滤提交的）

  提交太多了，不好找，就需要用一些特别的参数帮忙限制一下输出。例如只想找昨天的，只想找小明的，只想修改过A.txt 文件的等等各种只想，只要你敢想，基本都能实现。

• History Simplification （简化提交历史的）

  提交历史是默认显示全部的，如果你感觉没看到全部，不是人没给你，是你的命令行窗口太小了，需要往下翻翻页。如果你只想看某一部分的历史，可以用这一部分的命令。

• Commit Ordering （修改默认提交排序的）

  提交历史默认是按时间先后顺序排列的，最新的放在最上面。如果有其他排列需求，或者单纯看不惯，可以用这一部分的参数，去改。

• Commit Formatting （修改默认提交显示格式的）

  每个提交默认的显示信息，就是我们经常看到，有 SHA1 值，提交信息，作者和时间。但是呢，有些人想减去一点，有些人想多一点，有些人想换个显示方式，也是这些参数就诞生了。

• Diff Formatting（控制提交显示文件的差异格式的）

  diff 命令我们之前用过，会显示出修改的具体内容，也就是文件的差异，例如 --- com/A.txt +++ com/A.txt 。这个类别的命令，就是用来控制提交中显示此类差异的格式的。

看完这些分类的介绍，开心吗？

我是心情很复杂，参数太多，我都有点不太想去学了，看到后面前面的都忘了。于是，这里给大家推荐几个日常工作中比较常用的，提交过滤和提交历史格式化。

Commit Limiting 用来搜索提交再不过了

Search-作者

//命令格式
git log  --author=<pattern>
git log --committer=<pattern>
git log --author=“小明”
git log --author=“小明\|小红”
示例项目就我一个作者，没法试，但是我用公司项目试过，的确可以。
 
Search-时间
 
关于按时间搜索，支持的有很多类型，如下：
 
//某个日期之后
git log --since=<date>
git log --after=<date>
//某个日期之前
git log --until=<date>
git log --before=<date>
如果你想要一个具体的时间区间的，可以把这个参数组合起来的,例如下面的命令：
 
//查出 03.12-03.18 期间的提交
git log --since="2018.03.12" --until="2018.03.18"
Search-提交信息
 
这个就厉害了，你可以搜索提交信息,也支持正表达式
 
git log --grep=<pattern>
git log --grep='喜欢' --oneline
Search-修改内容
 
一般情况下，我们想找一个提交，大多是为了某个修改去找，这个修改对应要么是具体的文件，要么是具体的修改的内容。放心，这个条件也支持。
 
git log [\--] <path>…​
git log --oneline -- 11.txt
这一部分其实是 Diff 的参数部分，有很多参数，这里列出两个。
 
//查看某个字符串的变动历史提交
git log -S<string>
//查看某符合某一个正则表达式内容的变动历史提交  
git log -G<regex>
git log -S"喜欢你" --oneine
Search-合并相关的提交 & 文件
 
工作中，分支之间的合并，往往不是 fast-forword,而是 recursive strategy merge 策略式合并，所以会在历史中出现很多合并提交。运用下面的命令，你可以选择只看合并提交，或者非合并提交。
 
//查看合并提交
git log --merges
//查看非合并提交
git log --no-merges
不幸发生了合并冲突，还可以用这个命令，可以快速找到冲突的文件。
 
//查看发生合并冲突的文件
git log --merge
Commit History Formatting 你想要什么格式的你说
 
这个我们最常用的，显示 commit 的 SHA1 值，创建作者和时间，提交信息。
 
git log
一行情书版
 
使用 --oneline 参数，only one line !只显示提交的 SHA1 值和提交信息，SHA1 还是缩短显示前几位。
 
这个命令，在你要根据信息去找提交的时候，比 git log 的效率要高点。
 
git log --oneline
毫发毕现版
 
这个版本,就是上面说的，做到加持 git diff-*的效果版本，最常使用的参数是 --stat 和 -p。
 
git log --stat
git log -p
这个按提交的创建者分类，因为目前只有我一个操作，就显示了我一个人的。
 
使用这个命令可以容易地看到谁做了什么，毫无保留的。
 
git shortlog
图文并茂版
 
这次命令使用三个参数 --oneline， --decorate 和 --graph 。
 –oneline 刚才就是哪个一句话情书的。
 –graph 选项会绘制一个 ASCII 图像来展示提交历史的分支结构。
 –decorate 是用来可以显示出指向提交的指针的名字，也就是 HEAD 指针, feature/test等分支名称，还有远程分支，标签等。
 
git log --graph --oneline --decorate
最强推荐版
 
这个是在 stormZhang 张哥那里学来的：
 
git log --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit --date=relative
效果比较炫酷，这个已经属于自定义格式了，git log 支持自定义样式的，有兴趣的娃子可以自己研究下。而且这个命令比较长，娃子们可以通过给这个命令设置别名解决：
 
git config --global alias.lg "log --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit --date=relative"
这样以后直接输入 git lg 就行了。
 
这篇博客满足不了您的需求的同学们，自行去官方文档上看，这里再贴一下伟大的官方文档连接：git-log 官方文档连接在此，您请去吧！
 
最后，see you next blog 。
 
欢迎订阅我的Git系列文章
 
 01. 请回答：Git是什么？
 02. Git常用命令一日游活动
 03. Git三大特色之Branch(分支)
 04. Git三大特色之Stage(暂存区)
 05. Git三大特色之WorkFlow(工作流)
 06. Git-你好, HEAD 同学
 07. Git-用 cherry-pick 挑好看的小樱桃
 08. Git-rebase 黑魔法之打造完美的线性历史
 09. Git-rebase 黑魔法之打磨 commit 颗粒度
 10. Git-少年，你想学回滚吗？想撤销文件修改吗？
 11. Git-移动记录仪 & 贴心小棉袄 reflog
 12. Git-丢失的 commit 是真的消失了吗？
 13. Git-叹为观止的 log 命令 & 其参数
 14. Git-送娃子们一本关于如何自学 Git 的秘籍
 
  欢迎关注个人微信公众号「浅浅同学的开发笔记」，最新的博客，好玩的事情，都会在上面分享，期待与你共同成长。 
                                    git-changelog是用于生成通常在项目发行里程碑中分发的（又称为发行说明）的工具。 与其他执行相同操作的工具不同，该工具不需要您遵循任何特定的git工作流程约定。 它所假设的只是您将选择一些关键字（或使用内置关键字）来注释提交消息中的行。 具体而言，一个提交产生输出。
 当您希望记录用户可见的更改（例如，新功能，错误修复，重大更改等）时，您可以编写一条普通的提交消息，并用所选的关键字在其中注释一些行。 带注释的行在报表生成时用于将更改组织成类别和范围。 然后，将有组织的更改呈现为漂亮而准确的更改日志。
 没有标签的提交消息将被悄悄地忽略，您可以随意添加任意数量的标签。
 这是一个快速演示：
提交消息必须始终有意义，并且只需付出一点额外的努力，我们就可以自动完成为用户生成有意义的更改日志的工作。 当我完成变更工作时，我想暂停一下，考虑一下变更对最终用户意味着什么，并稍微重新组织
                                    笔者遇到一个问题，需要查看 Git 某个提交（commit）的时间，但是发现使用 Git 命令查看的时间与命令。而后三者显示的是一致的。作者日期（author date）：这指的是最开始提交时，所产生的提交文件上的日期。提交者日期（committer date）：这指的是对这个提交最后一次操作的日期。而且，更令人疑惑的是，对连续不同的提交，上面的那个命令显示的时间都是一样的。为什么上面那个命令是错的呢？，这个参数实际上显示的是提交时间。上面那个命令显示的是提交者时间，而命令。，因此上面那个命令是错的。
                                    Git Changelog库
 这是一个用于从GIT存储库生成变更日志或发行说明的库。 它也可以作为独立程序，Gradle插件，Maven插件或Jenkins插件运行。
 完全可以使用模板进行配置。 这样可以：
 存储到文件中，例如CHANGELOG.md 。 还有用于测试提供一些模板。
 或者只是呈现为String 。
 它可以与Jira和/或GitHub集成以检索问题的标题。
 该项目的将使用自动生成。
该软件可以使用：
 作为图书馆的 。
 这是一个示例模板。 
# Changelog
Changelog for {{ ownerName }} 
                                    git log命令非常强大而好用，在复杂系统的版本管理中扮演着重要的角色，但默认的git log命令显示出的东西实在太丑，不好好打扮一下根本没法见人，打扮好了用alias命令拍个照片，就正式出道了！...
                                    1.git log
如果不带任何参数，它会列出所有历史记录，最近的排在最上方，显示提交对象的哈希值，作者、提交日期、和提交说明。如果记录过多，则按Page Up、Page Down、↓、↑来控制显示；按q退出历史记录列表。
2.git log -n
如果不想向上面那样全部显示，可以选择显示前N条。
3.git log --stat -n
显示简要的增改行数统计,每次提交文件的变更统计，-...
                                    git log 可以让我们查看提交commit history,接下来我们来一起探索git log提供的参数。
$ git log
commit 0005d1e3f54b79fe4707fbccc44b89e0fb4ce565 (HEAD -&gt; master, origin/master, origin/HEAD)
Author: Carl Mungazi &lt;c_mungazi@hot...
本篇总结一下git-log的用法，不过以前的总结方式是通篇的翻译，这样感觉非常耽误时间，缺乏实际的效率，这篇文章尝试改进一下。
改进的思路是，先总结最常用的参数，然后逐步完善次常用的，再总结次次常用的。
git-log主要是用来显示提交日志的。
The command takes options applicable to the git rev-list command to co...
实际工作中，Author 并不一定就是Commit
另外：在查看提交摘要或者详情等情况下可能会出现 ：，这个冒号表示还有没展示完的内容，如果你想继续查看内容，就敲击键盘上的回车键；如果你想退出：，可以敲击键盘上的 q 。如下图：
git中查看提交历史的话，使用的是 git log命令，具体命令及含义如下：
1. git log
                                    git log命令详解git log 查看提交记录：-n (n是一个正整数)，查看最近n次的提交信息
  git log -2 查看最近2次的提交历史记录
–  fileNamefileName为任意文件名，查看指定文件的提交信息。(注：文件名应该放到参数的最后位置，通常在前面加上–并用空格隔开表示是文件。)
  git log file1 file2 查看file1文件file2文件的提交记录