Revise 5.3 Git log高级用法.
This commit is contained in:
ZhongyiTong
@ -4,21 +4,21 @@
|
||||
>
|
||||
> 这是一篇在[原文(BY atlassian)](https://www.atlassian.com/git/tutorials/git-log)基础上演绎的译文。除非另行注明，页面上所有内容采用知识共享-署名([CC BY 2.5 AU](http://creativecommons.org/licenses/by/2.5/au/deed.zh))协议共享。
|
||||
|
||||
每一个版本控制系统的出现都是为了让你记录代码的变化。你可以看到项目的历史记录——谁贡献了什么、bug是什么时候引入的，还可以撤回有问题的更改。但是，首先你得知道如何来使用它。这也就是为什么会有`git log` 这个命令。
|
||||
每一个版本控制系统的出现都是为了让你记录代码的变化。你可以看到项目的历史记录——谁贡献了什么、bug是什么时候引入的，还可以撤回有问题的更改。但是，首先你得知道如何使用它。这也就是为什么会有`git log` 这个命令。
|
||||
|
||||
到现在为止，你应该已经知道如何用`git log` 命令来显示最基本的提交信息。但除此之外，你还可以传入各种不同的参数来获得不一样的输出。
|
||||
|
||||
`git log` 有两个高级用法：一是自定义commit的输出格式，二是过滤哪些commit要输出。这两个用法合二为一，你就可以找到你项目中你需要的任何信息。
|
||||
`git log`有两个高级用法：一是自定义提交的输出格式，二是过滤输出哪些提交。这两个用法合二为一，你就可以找到你项目中你需要的任何信息。
|
||||
|
||||
## 格式化Log输出
|
||||
|
||||
首先，这篇文章会展示几种`git log` 格式化输出的例子。大多数例子只是通过标记来向`git log` 请求或多或少的信息。
|
||||
首先，这篇文章会展示几种`git log`格式化输出的例子。大多数例子只是通过标记向`git log`请求或多或少的信息。
|
||||
|
||||
如果你不喜欢默认的`git log` 格式，你可以用`git config` 的别名功能来给你想要的格式创建一个快捷方式。
|
||||
如果你不喜欢默认的`git log`格式，你可以用`git config`的别名功能来给你想要的格式创建一个快捷方式。
|
||||
|
||||
### Oneline
|
||||
|
||||
`--oneline` 标记把每一个commit压缩到了一行中。它默认只显示commit ID和commit信息的第一行。一般来说，`git log --oneline` 的输出是这样的：
|
||||
`--oneline`标记把每一个提交压缩到了一行中。它默认只显示提交ID和提交信息的第一行。`git log --oneline`的输出一般是这样的：
|
||||
|
||||
```
|
||||
0e25143 Merge branch 'feature'
|
||||
@ -27,13 +27,13 @@ ad8621a Fix a bug in the feature
|
||||
23ad9ad Add the initial code base
|
||||
```
|
||||
|
||||
它对于获得你项目的大致情况很有帮助。
|
||||
它对于获得项目的总体情况很有帮助。
|
||||
|
||||
### Decorate
|
||||
|
||||
很多时候，知道每个commit关联的分支或者标签很有用。`--decorate` 标记让`git log` 显示指向这个commit的所有引用（比如说分支、标签等）。
|
||||
很多时候，知道每个提交关联的分支或者标签很有用。`--decorate`标记让`git log`显示指向这个提交的所有引用（比如说分支、标签等）。
|
||||
|
||||
这可以和另一个配置项一起使用。比如，执行`git log --oneline --decorate` 会将commit历史格式化成这样：
|
||||
这可以和另一个配置项一起使用。比如，执行`git log --oneline --decorate` 会将提交历史格式化成这样：
|
||||
|
||||
```
|
||||
0e25143 (HEAD, master) Merge branch 'feature'
|
||||
@ -42,15 +42,15 @@ ad8621a (feature) Fix a bug in the feature
|
||||
23ad9ad (tag: v0.9) Add the initial code base
|
||||
```
|
||||
|
||||
在这个例子中，你可以看到最上面那个commit已经被checkout了（通过HEAD标记），而且它还是master分支的尾端。第二个commit有另一个feature分支指向它，以及最后那个commit带有v0.9标签。
|
||||
在这个例子中，你（通过HEAD标记）可以看到最上面那个提交已经被checkout了，而且它还是master分支的尾端。第二个提交有另一个feature分支指向它，以及最后那个提交带有v0.9标签。
|
||||
|
||||
分支、标签、HEAD还有commit历史是你Git仓库中包含的所有信息。因此，这个命令让你更完整地观察项目结构。
|
||||
分支、标签、HEAD还有提交历史是你Git仓库中包含的所有信息。因此，这个命令让你更完整地观察项目结构。
|
||||
|
||||
### Diff
|
||||
|
||||
`git log` 提供了很多选项来显示两个commit之间的差异。其中最常用的两个是`--stat` 和`-p`。
|
||||
`git log`提供了很多选项来显示两个提交之间的差异。其中最常用的两个是`--stat`和`-p`。
|
||||
|
||||
`--stat` 选项显示每次commit的文件增删数量（注意修改一行记作增加一行且删去一行），当你想要查看commit引入的变化时这会非常有用。比如说，下面这个commit在hello.py文件中增加了67行，删去了38行。
|
||||
`--stat`选项显示每次提交的文件增删数量（注意：修改一行记作增加一行且删去一行），当你想要查看提交引入的变化时这会非常有用。比如说，下面这个提交在hello.py文件中增加了67行，删去了38行。
|
||||
|
||||
```
|
||||
commit f2a238924e89ca1d4947662928218a06d39068c3
|
||||
@ -63,7 +63,7 @@ Date: Fri Jun 25 17:30:28 2014 -0500
|
||||
1 file changed, 67 insertion(+), 38 deletions(-)
|
||||
```
|
||||
|
||||
文件名后面+和-的数量是这个commit造成的更改中增删的相对比例。它给你一个直观的感觉，关于这次commit有多少改动。如果你想知道每次commit删改的绝对数量，你可以将`-p` 选项传入`git log` 。这样commit所有的删改都会被输出：
|
||||
文件名后面+和-的数量是这个提交造成的更改中增删的相对比例。它给你一个直观的感觉，关于这次提交有多少改动。如果你想知道每次提交删改的绝对数量，你可以将`-p` 选项传入`git log` 。这样提交所有的删改都会被输出：
|
||||
|
||||
```
|
||||
commit 16b36c697eb2d24302f89aa22d9170dfe609855b
|
||||
@ -81,13 +81,13 @@ index 18ca709..c673b40 100644
|
||||
+print("Hello, Git!")
|
||||
```
|
||||
|
||||
对于改动很多的commit来说，这个输出会变得又长又大。一般来说，当你输出所有删改的时候，你应该是想要查找某一具体的改动，这时你就要用到`pickaxe` 选项。
|
||||
对于改动很多的提交来说，这个输出会变得又长又大。一般来说，当你输出所有删改的时候，你是想要查找某一具体的改动，这时你就要用到`pickaxe` 选项。
|
||||
|
||||
### Shortlog
|
||||
|
||||
`git shortlog` 是一种特别的`git log` ，它是为创建发布声明设计的。它把每个commit按作者分类，显示commit信息的第一行。这样可以容易地看到谁做了什么。
|
||||
`git shortlog`是一种特殊的`git log` ，它是为创建发布声明设计的。它把每个提交按作者分类，显示提交信息的第一行。这样可以容易地看到谁做了什么。
|
||||
|
||||
比如说，两个开发者为项目贡献了5个commit，那么`git shortlog` 输出会是这样的：
|
||||
比如说，两个开发者为项目贡献了5个提交，那么`git shortlog` 输出会是这样的：
|
||||
|
||||
```
|
||||
Mary (2):
|
||||
@ -100,11 +100,11 @@ John (3):
|
||||
Merge branch 'feature'
|
||||
```
|
||||
|
||||
默认情况下，`git shortlog` 把输出按作者名字排序，但你可以传入`-n` 选项来按每个作者commit数量排序。
|
||||
默认情况下，`git shortlog`把输出按作者名字排序，但你可以传入`-n`选项来按每个作者提交数量排序。
|
||||
|
||||
### Graph
|
||||
|
||||
`--graph` 选项绘制一个ASCII图像来展示commit历史的分支结构。它经常和 `--oneline` 和 `--decorate` 两个命令一起使用，这样会更容易查看哪个commit属于哪个分支：
|
||||
`--graph` 选项绘制一个ASCII图像来展示提交历史的分支结构。它经常和 `--oneline`和 `--decorate`两个选项一起使用，这样会更容易查看哪个提交属于哪个分支：
|
||||
|
||||
```
|
||||
git log --graph --oneline --decorate
|
||||
@ -120,15 +120,15 @@ For a simple repository with just 2 branches, this will produce the following:
|
||||
* 160e224 Add the initial code base
|
||||
```
|
||||
|
||||
星号表明这个commit所在的分支，所以上面这个图的意思是`23ad9ad` 和`16b36c6` 这两个commit在topic分之上，其余的在master分支上。
|
||||
星号表明这个提交所在的分支，所以上图的意思是`23ad9ad`和`16b36c6`这两个提交在topic分支上，其余的在master分支上。
|
||||
|
||||
虽然这对简单的项目来说是个很好用的选择，但你可能会更喜欢gitk或SourceTree这些更强大的可视化工具来分析大型项目。
|
||||
|
||||
### 自定义格式
|
||||
|
||||
对于其他的`git log` 格式需求，你都可以使用`--pretty=format:"<string>"` 选项。它允许你使用像printf一样的占位符来输出commit。
|
||||
对于其他的`git log`格式需求，你都可以使用`--pretty=format:"<string>"`选项。它允许你使用像printf一样的占位符来输出提交。
|
||||
|
||||
比如，下面命令中的`%cn`、`%h` 和`%cd` 这三种占位符会被分别替换为作者名字、缩略标识和提交日期。
|
||||
比如，下面命令中的`%cn`、`%h` 和`%cd`这三种占位符会被分别替换为作者名字、缩略标识和提交日期。
|
||||
|
||||
```
|
||||
git log --pretty=format:"%cn committed %h on %cd"
|
||||
@ -146,13 +146,13 @@ John committed f12ca28 on Wed Jun 22 13:50:31 2014 -0500
|
||||
|
||||
## 过滤提交历史
|
||||
|
||||
格式化commit输出只是`git log` 其中的一个用途。另一半是理解如何浏览整个提交历史。接下来的文章会介绍如何用`git log` 选择项目历史中的特定的commit。所有的用法都可以和上面讨论过的格式化选项结合起来。
|
||||
格式化提交输出只是`git log`其中的一个用途。另一半是理解如何浏览整个提交历史。接下来的文章会介绍如何用`git log`选择项目历史中的特定提交。所有的用法都可以和上面讨论过的格式化选项结合起来。
|
||||
|
||||
### 按数量
|
||||
|
||||
`git log` 最基础的过滤选项是限制显示的commit数量。当你只对最近几次commit感兴趣时，它可以节省你一页一页查看的时间。
|
||||
`git log`最基础的过滤选项是限制显示的提交数量。当你只对最近几次提交感兴趣时，它可以节省你一页一页查看的时间。
|
||||
|
||||
你可以在后面加上`-<n>`选项。比如说，下面这个命令会显示最新的3次commit：
|
||||
你可以在后面加上`-<n>`选项。比如说，下面这个命令会显示最新的3次提交：
|
||||
|
||||
```
|
||||
git log -3
|
||||
@ -160,7 +160,7 @@ git log -3
|
||||
|
||||
### 按日期
|
||||
|
||||
如果你想要查看某一特定时间段内的commit，你可以使用`--after` 或 `--before` 标记来按日期筛选。它们都接受好几种日期格式作为参数。比如说，下面的命令会显示2014年7月1日后（含）的commit：
|
||||
如果你想要查看某一特定时间段内的提交，你可以使用`--after` 或 `--before` 标记来按日期筛选。它们都接受好几种日期格式作为参数。比如说，下面的命令会显示2014年7月1日后（含）的提交：
|
||||
|
||||
```
|
||||
git log --after="2014-7-1"
|
||||
@ -172,25 +172,25 @@ git log --after="2014-7-1"
|
||||
get log --after="yesterday"
|
||||
```
|
||||
|
||||
你可以同时提供`--before` 和 `--after` 来检索两个日期之间的commit。比如，为了显示2014年7月1日到2014年7月4日之间的commit，你可以这么写：
|
||||
你可以同时提供`--before` 和 `--after` 来检索两个日期之间的提交。比如，为了显示2014年7月1日到2014年7月4日之间的提交，你可以这么写：
|
||||
|
||||
```
|
||||
git log --after="2014-7-1" --before="2014-7-4"
|
||||
```
|
||||
|
||||
注意`--since` 、`--until` 标记和`--after` 、`--before` 标记分别是等价的。
|
||||
注意`--since` 、`--until` 标记和`--after` 、`--before`标记分别是等价的。
|
||||
|
||||
### 按作者
|
||||
|
||||
当你只想看某一特定作者的commit的时候，你可以使用`--author` 标记。它接受正则表达式，返回所有作者名字满足这个规则的commit。如果你知道那个作者的确切名字你可以直接传入文本字符串：
|
||||
当你只想看某一特定作者的提交的时候，你可以使用`--author`标记。它接受正则表达式，返回所有作者名字满足这个规则的提交。如果你知道那个作者的确切名字你可以直接传入文本字符串：
|
||||
|
||||
```
|
||||
git log --author="John"
|
||||
```
|
||||
|
||||
它会显示所有作者叫John的commit。作者名不一定是全匹配，只要包含那个子串就会匹配。
|
||||
它会显示所有作者叫John的提交。作者名不一定是全匹配，只要包含那个子串就会匹配。
|
||||
|
||||
你也可以用正则表达式来创建更复杂的检索。比如，下面这个命令检索名叫Mary或John的作者的commit。
|
||||
你也可以用正则表达式来创建更复杂的检索。比如，下面这个命令检索名叫Mary或John的作者的提交。
|
||||
|
||||
```
|
||||
git log --author="John\|Mary"
|
||||
@ -198,85 +198,85 @@ git log --author="John\|Mary"
|
||||
|
||||
注意作者的邮箱地址也算作是作者的名字，所以你也可以用这个选项来按邮箱检索。
|
||||
|
||||
如果你的工作流区分提交者和作者，`--committer` 也能以相同的方式使用。
|
||||
如果你的工作流区分提交者和作者，`--committer`也能以相同的方式使用。
|
||||
|
||||
### 按提交信息
|
||||
|
||||
按提交信息来过滤commit，你可以使用`--grep` 标记。它和上面的`--author` 标记差不多，只不过它搜索的是提交信息而不是作者。
|
||||
按提交信息来过滤提交，你可以使用`--grep`标记。它和上面的`--author`标记差不多，只不过它搜索的是提交信息而不是作者。
|
||||
|
||||
比如说，你的团队规范要求在提交信息中包括相关的issue编号，你可以用下面这个命令来显示这个issue相关的所有commit：
|
||||
比如说，你的团队规范要求在提交信息中包括相关的issue编号，你可以用下面这个命令来显示这个issue相关的所有提交：
|
||||
|
||||
```
|
||||
git log --grep="JRA-224:"
|
||||
```
|
||||
|
||||
你也可以传入`-i` 参数来忽略大小写匹配。
|
||||
你也可以传入`-i`参数来忽略大小写匹配。
|
||||
|
||||
### 按文件
|
||||
|
||||
很多时候，你只对某个特定文件的更改感兴趣。为了显示某个特定文件的历史，你只需要传入文件路径。比如说，下面这个命令返回所有和`foo.py` 和`bar.py` 文件相关的commit：
|
||||
很多时候，你只对某个特定文件的更改感兴趣。为了显示某个特定文件的历史，你只需要传入文件路径。比如说，下面这个命令返回所有和`foo.py`和`bar.py`文件相关的提交：
|
||||
|
||||
```
|
||||
git log -- foo.py bar.py
|
||||
```
|
||||
|
||||
`--` 告诉`git log` 接下来的参数是文件路径而不是分支名。如果分支名和文件名不可能冲突，你可以省略`--`。
|
||||
`--`告诉`git log`接下来的参数是文件路径而不是分支名。如果分支名和文件名不可能冲突，你可以省略`--`。
|
||||
|
||||
### 按内容
|
||||
|
||||
我们还可以根据源代码中某一行的增加和删除来搜索commit。这被称为pickaxe，它接受形如`-S"<string>"` 的参数。比如说，当你想要知道`Hello, World!` 字符串是什么时候加到项目中哪个文件中去的，你可以使用下面这个命令：
|
||||
我们还可以根据源代码中某一行的增加和删除来搜索提交。这被称为pickaxe，它接受形如`-S"<string>"`的参数。比如说，当你想要知道`Hello, World!`字符串是什么时候加到项目中哪个文件中去的，你可以使用下面这个命令：
|
||||
|
||||
```
|
||||
git log -S "Hello, World!"
|
||||
```
|
||||
|
||||
如果你想用正则表达式而不是字符串来搜索，你可以使用`-G"<regex>"` 标记。
|
||||
如果你想用正则表达式而不是字符串来搜索，你可以使用`-G"<regex>"`标记。
|
||||
|
||||
这是一个非常强大的调试工具，它能让你定位到所有影响代码中特定一行的commit。它甚至可以让你看到某一行是什么时候复制或者移动到另一个文件中去的。
|
||||
这是一个非常强大的调试工具，它能让你定位到所有影响代码中特定一行的提交。它甚至可以让你看到某一行是什么时候复制或者移动到另一个文件中去的。
|
||||
|
||||
### 按范围
|
||||
|
||||
你可以传入范围来筛选commit。这个范围由下面这样的格式指定，其中< since > 和< until >是commit的引用：
|
||||
你可以传入范围来筛选提交。这个范围由下面这样的格式指定，其中`<since>`和`<until>`是提交的引用：
|
||||
|
||||
```
|
||||
git log <since>..<until>
|
||||
```
|
||||
|
||||
这个命令在你使用分支引用作为参数时特别有用。这是一个显示两个分支之间区别最简单的方式。看看下面这个命令：
|
||||
这个命令在你使用分支引用作为参数时特别有用。这是显示两个分支之间区别最简单的方式。看看下面这个命令：
|
||||
|
||||
```
|
||||
git log master..feature
|
||||
```
|
||||
|
||||
其中的master..feature范围包含了在feature分支而不在feature分支中所有的commit。换句话说，这个命令可以看出从master分支Fork到feature分支后发生了哪些变化。它可以这样可视化：
|
||||
其中的master..feature范围包含了在feature分支而不在master分支中所有的提交。换句话说，这个命令可以看出从master分支fork到feature分支后发生了哪些变化。它可以这样可视化：
|
||||
|
||||
|
||||
|
||||
注意如果你更改范围的前后顺序(feature..master)，你会获取到master分支而非feature分支上的所有commit。如果`git log` 输出了全部两个分支的commit，这说明你的提交历史已经分叉了。
|
||||
注意如果你更改范围的前后顺序(feature..master)，你会获取到master分支而非feature分支上的所有提交。如果`git log`输出了全部两个分支的提交，这说明你的提交历史已经分叉了。
|
||||
|
||||
### 过滤出merge commit
|
||||
### 过滤合并提交
|
||||
|
||||
`git log` 输出时默认包括merge commit。但是，如果你的团队采用强制合并策略（意思是merge上游修改你的分支而不是将你的分支rebase到上游分支），你的项目历史中会有很多外来的commit。
|
||||
`git log`输出时默认包括合并提交。但是，如果你的团队采用强制合并策略（意思是merge你修改的上游分支而不是将你的分支rebase到上游分支），你的项目历史中会有很多外来的提交。
|
||||
|
||||
你可以通过`--no-merges` 标记来排除这些commit：
|
||||
你可以通过`--no-merges`标记来排除这些提交：
|
||||
|
||||
```
|
||||
git log --no-merges
|
||||
```
|
||||
|
||||
另一方面，如果你只对merge commit感兴趣，你可以使用`--merges` 标记：
|
||||
另一方面，如果你只对合并提交感兴趣，你可以使用`--merges`标记：
|
||||
|
||||
```
|
||||
git log --merges
|
||||
```
|
||||
|
||||
它会返回所有有两个父节点的commit。
|
||||
它会返回所有包含两个父节点的提交。
|
||||
|
||||
## 总结
|
||||
|
||||
你现在应该对使用`git log` 来格式化输出和选择你要显示的commit的用法比较熟悉了。它允许你查看你项目历史中任何需要的内容。
|
||||
你现在应该对使用`git log`来格式化输出和选择你要显示的提交的用法比较熟悉了。它允许你查看你项目历史中任何需要的内容。
|
||||
|
||||
这些技巧是你Git工具箱中重要的部分，不过注意`git log` 往往和其他Git命令连着使用。当你找到了你要的commit，你把它传给`git checkout` 、`git revert` 或是其他控制你提交历史的工具。所以，请继续坚持Git高级用法的学习。
|
||||
这些技巧是你Git工具箱中重要的部分，不过注意`git log`往往和其他Git命令连着使用。当你找到了你要的提交，你把它传给`git checkout` 、`git revert` 或是其他控制提交历史的工具。所以，请继续坚持Git高级用法的学习。
|
||||
|
||||
|
||||
|
||||
@ -285,4 +285,3 @@ git log --merges
|
||||
> 如果你觉得文章对你有帮助，欢迎点击右上角的***Star***:star2:或***Fork***:fork_and_knife:。
|
||||
>
|
||||
> 如果你发现了错误，或是想要加入协作，请参阅[Wiki协作说明](https://github.com/geeeeeeeeek/git-recipes/issues/1)。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user