log

作者: 一江碎月 | 来源:发表于2017-09-04 17:05 被阅读0次

    常用选项

    选项 含义
    -n 查看最近 n 条提交记录
    --grep <msg> 搜索提交说明中的关键字
    --since="yyyy-m-dd" --until="yyyy-m-d" 搜索指定时间段内的提交
    --after --before 同 since 与 until
    --left-right 用于指向当前的提交到底属性哪个引用
    -S"<string>" 或 -G 用于搜索 string 提交和删除的版本。-G 用于正则表达式
    -L 跟踪指定的行的演变过程
    --merge 显示任何一边接触了合并冲突文件的提交

    log 命令也可用于指定的文件,只需要将文件与命令通过 -- 分隔即可。如:

    $ git log -- ee 
    

    该语句只会返回 ee 文件的提交历史。

    基本命令

    使用 git log 查看提交历史

    1. 默认不使用参数时,该命令会按时间倒序列出所有的提交历史。

    2. 使用 -p 选项列出每次提交的修改内容,可以看到本次提交进行的修改。

    3. 使用 -n 列出最近的 n 条记录。例如 git log -2 列出最近两条历史记录。

    4. 使用 --stat(statistics 统计的缩写) 列出每次提交的增改行数统计

    5. 使用 --pretty=<value> 指定日志的输出格式。如

      git log --pretty=oneline
      

      会将记录放在一行显示。oneline 只显示每一次提交的 SHA1 值以及提交的文字说明。

      --pretty 可用的选项有oneline , full , fuller , short 和 format(后需要跟指定的格式)

      • 普通的 git log 会显示如下信息:
      $ git log -1
      commit ca82a6dff817ec66f44342007202690a93763949
      Author: Scott Chacon <schacon@gmail.com>
      Date:   Mon Mar 17 21:52:11 2008 -0700
      
          changed the verison number
      
      • 使用 --pretty=online 时,只会显示 commit 与 最下面的文字说明,并且显示在一行;

      • 使用 --pretty=full 时,会在普通的 git log 基本上多加一条 “Commit” ,它指的是提交者;

      • 使用 --pretty=fuller 时,会在 full 基础上添加 “AuthorDate” 与 "CommitDate";

      • 使用 --pretty=short 时,会比普通 log 少 Date 行。

    6. 使用--author=<name> 指定仅显示指定作者的相关提交

      git log --author=global -2
      
    7. 使用--committer=<name> 指定仅显示指定提交者相关的提交。具体使用方法与author相同。

    8. 使用 --grep 搜索提交说明中的关键字

      git log --grep=log -2
      

      用于检索提交说明中含有 log 的提交。

    9. 如果只关心某些文件或目录的提交历史,可以在 log 的最后跟上路径,并且需要使用 -- 隔开路径与选项

      git log --grep=log -2 -- /test
      

      通过 -- 隔开路径与选项,查询到的历史记录只有 test 目录的。

    10. 使用 --since 或 --after 显示指定时间之后的提交

    11. 使用 --until 或 --before 显示指定时间之前的提交

       git log --after="2017-9-2" --before="2017-9-4"
      

      该命令会列出从9月2号(含)到9月4号(含)所有的提交记录。

    12. --left-right 与 ... 运算符结合使用,用于指明提交到底属于哪个引用。如:

      $ git log --left-right dev...master
      commit < e46a0a492fa5a77a7709ba3d201c9a226297bce1
      commit > db496c69ad86e2a4cb5f58a9da2b998498651080
      commit > d7b0598e71391add76559f118186b39474468098
      commit > 9b3a660fdeda67bd8dcf428719eaf84b1fb412f2
      

    -S 与 -G

    -S 用于查找指定的字符串添加或删除的版本。-G 与 -S 类似,只不过 -G 用于正则表达式匹配

    注意:-S 与查询的内容之间不能出现空格。

    $ git log -S"a11" --oneline
    94689ef del a11
    9fabba9 clean
    

    9fabba9 是 a11 第一次出现的版本;94689ef 是 a11 删除的版本。

    $ git log -G"a1{2}" --oneline
    94689ef del a11
    9fabba9 clean
    

    返回结果与 -S 一样,只不过 -G 后跟的是正则表达式。


    -L

    用于查找指定的范围内的行的演变过程。

    有两种格式:-L <start>,<end>:<file>-L :<funcname>:<file>

    1. 如果 start 与 end 都是数字,它表示指定的行号(行号从 1 开始)。如:

      $ git log -L 2,4:a.txt
      

      上述命令就会返回 a.txt 文件第 2 行到第 4 行的变更记录。

    2. start 与 end 都是正则表达式。

      • 写正则表达式时,表达式需要用 // 包裹起来

      • start 将从前一个 -L 范围的末尾(如果有的话)搜索,否则从文件开头搜索。

      • 如果 <start> 是 “^/ regex /”,它将从文件开头搜索。

      • end 将从 start 给出的行开始搜索。

      • 与直接指定数字相比,使用表达式可以在满足条件的行之间删除或添加行。

      $     git log -L "/a3\{2\}/","/a5\{2\}/":aa
      commit 3a4721694a888a876d062ac90bca03115b3394b7
      Author: global <global@mail.com>
      Date:   Thu Mar 29 21:52:52 2018 +0800
      
      a44
      
      diff --git a/aa b/aa
      --- a/aa
      +++ b/aa
      @@ -2,3 +2,4 @@
       a33
       a4
      +a444
       a55
      

      上述代码会展示满足表达式 a3{2} 的行到满足表达式 a5{2} 的行的变迁过程。

      由上例可以发现,最近一次修改后,在 a33 与 a55 之间添加了一行 a444。

    3. 对于 -L :<funcname>:<file> 可以用于检索 file 文件中 funcname 方法的变迁过程

      $ git log -L :test:test.html
      commit a6863836d1d54c00035511824758a8da6dfed83b
      Author: global <global@mail.com>
      Date:   Thu Mar 29 22:00:47 2018 +0800
      
      update test func
      
      diff --git a/test.html b/test.html
      --- a/test.html
      +++ b/test.html
      @@ -1,3 +1,4 @@
       public void test(){
      +   print("bb");
          print("aa");
       }
      

      上述命令用于获取 test.html 中 test 方法的变迁过程。

      由输出可以知道,最近一次提交是在 test 方法中添加了 print("bb"); 行。

      每一次输出的内容都是第 n 次提交与第 n+1 提交的对比结果。+ 号行表示的是第 n+1 次提交添加的行,- 号行表示第 n+1 次提交删掉的行。


    --merge

    用于显示跟冲突位置相关的提交

    在运行 git merge 出现冲突文件后,可以运行 git log --merge 命令查看跟冲突区域相关的提交。如:

    $ git log --merge --left-right --oneline
    < 86ceb32 update a2
    > 5909e8e update dev
    

    其中 > 指向的是被合并分支中跟冲突相关的提交,< 指向的是当前分支中跟冲突相关的提交。

    相关文章

      网友评论

          本文标题:log

          本文链接:https://www.haomeiwen.com/subject/tzjejxtx.html