常用选项
选项 | 含义 |
---|---|
-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 查看提交历史。
-
默认不使用参数时,该命令会按时间倒序列出所有的提交历史。
-
使用 -p 选项列出每次提交的修改内容,可以看到本次提交进行的修改。
-
使用 -n 列出最近的 n 条记录。例如 git log -2 列出最近两条历史记录。
-
使用 --stat(statistics 统计的缩写) 列出每次提交的增改行数统计。
-
使用 --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 行。
-
使用--author=<name> 指定仅显示指定作者的相关提交
git log --author=global -2
-
使用--committer=<name> 指定仅显示指定提交者相关的提交。具体使用方法与author相同。
-
使用 --grep 搜索提交说明中的关键字。
git log --grep=log -2
用于检索提交说明中含有 log 的提交。
-
如果只关心某些文件或目录的提交历史,可以在 log 的最后跟上路径,并且需要使用 -- 隔开路径与选项。
git log --grep=log -2 -- /test
通过 -- 隔开路径与选项,查询到的历史记录只有 test 目录的。
-
使用 --since 或 --after 显示指定时间之后的提交。
-
使用 --until 或 --before 显示指定时间之前的提交。
git log --after="2017-9-2" --before="2017-9-4"
该命令会列出从9月2号(含)到9月4号(含)所有的提交记录。
-
--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>。
-
如果 start 与 end 都是数字,它表示指定的行号(行号从 1 开始)。如:
$ git log -L 2,4:a.txt
上述命令就会返回 a.txt 文件第 2 行到第 4 行的变更记录。
-
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。
-
-
对于 -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
其中 >
指向的是被合并分支中跟冲突相关的提交,<
指向的是当前分支中跟冲突相关的提交。
网友评论