深入浅出git-log之代码统计实战

前言

git-log 即查看 git 提交日志，本文会全面解析 git-log 使用并通过一个真实的 SpringBoot 项目进行实战。如果你是个技术管理者，你一定在乎手下做了什么，提了多少代码，是否有“佛祖保佑”，git-log 都可以帮你搞定。它还可帮你 code review，帮你 blame someone。你想 blame 吗？你想快速定位你的代码吗？那就看看我们的 git log 到底能做点啥吧。Let's Go~

概要

$ git log [] [] [[--] …]

• 本文会用到以下两种命令做 demo，一种普通 log，一种单行显示 log

# 普通log
$ git log
# 单行显示
$ git log --oneline

选项options

• --follow:会追溯历史，包括重命名前的记录

  $ git log -p gradle.properties
  # 不带 follow参数的情况下，git把名为gradle.properties的文件全部提交记录找出来
  $ git log -p --follow gradle.properties
  # 带follow参数的情况下，git会把当前以及重命名前的文件提交记录找出来
  

• --no-decorate:不显示的所有提交的引用名称

  $ git log --no-decorate
  

  commit hash
  Author: caining 
  Date:  Tue Apr 20 11:10:53 2021 +0800
  develop2
  

• --decorate[=short|full|auto|no]:显示的所有提交的引用名称

  • 名词解释：Git Reference
    • Git Reference简写为refs
    • 本地分支的Reference格式：refs/heads/如refs/heads/master，在保证唯一的情况下可以简写为master；
    • 远程追踪分支的Reference格式：refs/remotes//：如refs/remotes/origin/master，在保证唯一的情况下可以简写为origin/master；
    • tag的Reference格式：refs/tags/：如refs/tags/v1.0.1，在保证唯一的情况下可以简写为v1.0.1
    • 特殊refs-HEAD，指向当前本地分支的当前commit状态
    • 特殊refs-FETCH_HEAD，指向当前本地分支在最近一次fetch操作时得到的commit状态
    • 特殊refs-ORIG_HEAD，指向任何merge或rebase之前的刚刚检出时的commit状态

  $ git log --decorate=full
  # 结果：HEAD -> refs/heads/develop , refs/remotes/origin/develo
  $ git log --decorate=short
  # 结果：HEAD -> develop, origin/develop
  

• --source:均显示提交分支

  # 每个提交均显示提交分支
  $ git log --oneline --source
  # 6256aa140       HEAD (HEAD -> develop, origin/develop) message
  

• --log-size:是该提交消息的长度（以字节为单位）

  $ git log --oneline --log-size
  
  # commit 6256aa140f910d81eb71a7651aad1d6bc5128da0 (HEAD -> develop, origin/develop)
  # log size 107
  # Author: caining 
  # Date:  Thu Apr 22 09:59:29 2021 +0800
  # message
  

• -L,::查看某个文件某几行范围内的修改记录

  $ git log -L 1,1:README.md
  

• -L:::追踪一个函数的变更历史

  • 为了保证该命令执行有效，Git 需要知道哪些行是函数声明。Git有一套默认的正则表达式，但是由于语言比较多，默认配置下可能遇到这种报错：fatal: -L parameter 'test' starting at line 1: no match
  • 分析原因：在某些语言中，Git 默认的正则表达式无法识别该语言的函数开始和结束标识导致无法匹配函数名称
  • 解决方法
    • 项目下新建.gitattributes文件 关于gitattributes
    • 配置对应语言的diff*.java diff=java

  $ git log -L :test:app/src/main/java/com/cnn/androidmavenpackage/MainActivity.java
  

  

重点-筛选

• 请注意，这些是在提交顺序和格式设置选项（例如--reverse）之前应用的。显示提交日志，以下 a b c 均为提交节点 hash 值 commit 时间 a < b < c )

  # 普通log
  $ git log
  # 单行显示
  $ git log --oneline
  

  # 列出a到(画重点：理解^ 可以理解为from  前面大 后面小，..可以理解为to 前面小后面大)
  $ git log a..b
  $ git log b ^a
  

  #列出所有可以从a 到 b而不包含c之前的提交
  $ git log a b ^c
  

• 数量筛选

  $ git log -3
  $ git log -n3
  $ git log --max-count=3
  # - 
  # -n 
  # --max-count=
  # --skip=
  $ git log --skip=3 #跳过3条记录
  

• 时间筛选

  $ git log --since='2021-04-02 00:00:00'
  # --since=
  # --after=
  $ git log --until='2021-04-02 00:00:00'
  # --until=
  # --before=
  # 2周内的提交
  $ git log --since=2.weeks = $ git log --since="2 weeks ago"
  # 2月内的提交
  $ git log --since=2.months = $ git log --since="2 months ago"
  # 1年内的提交
  $ git log --since=1.year = $ git log --since="1 year ago"
  

• 作者筛选

  $ git log --author='caining'
  # --author=
  # --committer=
  # 注意这里是正则，模糊匹配，
  # 如果是多个人人一起查按下面
  $ git log -author="name1\|name2\|name3"
  

• 提交描述筛选

  $ git log --grep='bug fix'
  $ git log -i --grep="message1\|message2"
  # --grep=
  # 重点1： --all-match 可以理解为sql-and与 --grep 至少有一个匹配的提交 例如与-author混用时
  $ git log --author='caining' --all-match --grep='bug fix'
  # 重点2： --invert-grep 用法同上，可以理解为sql not --grep 至少有一个不匹配的提交 例如与-author混用时
  $ git log --author='caining' --invert-grep --grep='bug fix'
  #上句理解： 为caining 提交的 但是 描述里不包含 bug fix的 提交内容
  

• 代码内容搜索 -S，注意这个搜索可能很耗时。

  $ git log -S hello
  

• 多条件混合筛选

  $ git log --since=1.year --author='caining' --grep='获取' -3
  

format与样式

• --pretty[=

• --date=：--date=relative``--date=local``--date=default-local.--date=iso --date=iso8601``--date=rfc``--date=short``--date=rfc2822

  日期格式化

• --parents

  显示提交的父母节点

• --children

  显示提交的孩子节点

• --graph

  --graph like this

• git log --pretty=format 已存在样式包含 oneline,short, medium, full, fuller, reference, email, raw

  $ git log --pretty=oneline
  # 样式:
  #