git log命令全解析，打log还能这么随心所欲！

git log 命令非常强大而好用，在复杂系统的版本管理中扮演着重要的角色，但默认的 git log 命令显示出的东西实在太丑，不好好打扮一下根本没法见人，打扮好了用 alias 命令拍个照片，就正式出道了！

下面先详细而系统地介绍 git log 的所有配置知识（用我一向简洁清晰的表述方式），熟悉了这些东西，你就可以自由配置自己美丽的 git log 了～
最后上个干货，直接给一个我打扮好的 alias 配置，懒人直接跳到最后吧！

git log 用于查询版本的历史，命令形式如下：git log [<options>] [<since>..<until>] [[--] <path>...]

不带参数

如果不带任何参数，它会列出所有历史记录，最近的排在最上方，显示提交对象的哈希值，作者、提交日期、和提交说明
如果记录过多，则按Page Up、Page Down、↓、↑来控制显示
按q退出历史记录列表

显示参数

p：按补丁显示每个更新间的差异，比下一条 -stat 命令信息更全
-stat：显示每次更新的修改文件的统计信息，每个提交都列出了修改过的文件，以及其中添加和移除的行数，并在最后列出所有增减行数小计
-shortstat：只显示 -stat 中最后的行数添加修改删除统计
-name-only：尽在已修改的提交信息后显示文件清单
-name-status：显示新增、修改和删除的文件清单
-abbrev-commit：仅显示SHA-1的前几个字符，而非所有的40个字符
-relative-date：使用较短的相对时间显示（例如：”two weeks ago”）
-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(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；内容可以是占位元字符，也可以是直接显示的普通字符。
-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

筛选参数

按数量
1. n：显示前n条log
按日期
1. -after=
  1. 比如 git log --after="2014-7-1”，显示2014年7月1号之后的commit(包含7月1号)
  2. 后边的日期还可以用相对时间表示，比如”1 week ago”和”yesterday”，比如 git log --after="yesterday"
  3. 这里的格式可以是什么？
2. -before=
  1. 同上
  2. 另外这两条命令可以同时使用表示时间段，比如 git log --after="2014-7-1" --before="2014-7-4"
  3. 另外 --since --until 和 --after`` --before 是一个意思，都可以用
按作者
1. -author=
  1. 比如 git log --author=“John"，显示John贡献的commit
  2. 注意：作者名不需要精确匹配，只需要包含就行了
  3. 而且：可以使用正则表达式，比如 git log --author="John\|Mary”，搜索Marry和John贡献的commit
  4. 而且：这个 --author 不仅包含名还包含email, 所以你可以用这个搜索email
按commit描述
1. -grep=
  1. 比如：git log --grep="JRA-224"
  2. 而且：可以传入-i用来忽略大小写
  3. 注意：如果想同时使用 --grep 和 --author，必须在附加一个 --all-match 参数
按文件
1. （空格）或［没有］
  1. 有时你可能只对某个文件的修改感兴趣, 你只想查看跟某个文件相关的历史信息, 你只需要插入你感兴趣文件的路径［对，是路径，所以经常是不太好用］就可以了
  2. 比如：git log -- foo.py bar.py，只返回和 foo.py 或 bar.py 相关的 commit
  3. 这里的–是告诉 Git 后面的参数是文件路径而不是 branch name. 如果后面的文件路径不会和某个 branch 产生混淆, 你可以省略 --，比如 git log foo.py
  4. 另外，后边的路径还支持正则，比如：git log *install.md 是，指定项目路径下的所有以 install.md 结尾的文件的提交历史
  5. 另外，文件名应该放到参数的最后位置，通常在前面加上 -- 并用空格隔开表示是文件
  6. 另外，git log file/ 查看 file 文件夹下所有文件的提交记录
按分支
1. 1. -branchName branchName为任意一个分支名字，查看某个分支上的提交记录
  2. 需要放到参数中的最后位置处
  3. 如果分支名与文件名相同，系统会提示错误，可通过–选项来指定给定的参数是分支名还是文件名
    1. 比如：在当前分支中有一个名为v1的文件，同时还存在一个名为v1的分支
    2. git log v1 -- 此时的v1代表的是分支名字（－－后边是空的）
    3. git log -- v1 此时的v1代表的是名为v1的文件
    4. git log v1 －－ v1 代表v1分支下的v1文件
按内容
1. -S"<>"、-G"<>"
  1. 有时你想搜索和新增或删除某行代码相关的commit. 可以使用这条命令
  2. 假设你想知道Hello, World!这句话是什么时候加入到项目里去的，可以用：git log -S"Hello,World!"
  3. 另外：如果你想使用正则表达式去匹配而不是字符串, 那么你可以使用-G代替-S.
  4. 这是一个非常有用的debug工具, 使用他你可以定位所有跟某行代码相关的commit. 甚至可以查看某行是什么时候被copy的, 什么时候移到另外一个文件中去的
  5. 注：-S后没有”=”，与查询内容之间也没有空格符
按范围
1. git log <since>..<until>
  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分支中的提交记录
过滤掉 merge commit
1. -no-merges
  1. 默认情况下 git log 会输出 merge commit. 你可以通过 --no-merges 标记来过滤掉 merge commit，git log --no-merges
  2. 另外，如果你只对 merge commit 感兴趣可以使用 —merges，git log --merges
按标签tag
1. git log v1.0
  1. 直接这样是查询标签之前的commit
  2. 加两个点 git log v1.0.. 查询从v1.0以后的提交历史记录(不包含v1.0)
按commit
1. git log commit ：查询commit之前的记录，包含commit
2. git log commit1 commit2：查询commit1与commit2之间的记录，包括commit1和commit2
3. git log commit1..commit2：同上，但是不包括commit1
  1. 其中，commit可以是提交哈希值的简写模式，也可以使用HEAD代替
    1. HEAD代表最后一次提交，HEAD^为最后一个提交的父提交，等同于HEAD～1
    2. HEAD～2代表倒数第二次提交

最后干货，你会喜欢的~

下面第一条的效果是这样：

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](http://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"

参考

git log命令全解析，打log还能这么随心所欲！

#git

面试官家常之Handler、MessageQueue 和 Looper 上一篇

git 的 merge, rebase 和 squash 下一篇