[译]git log

git log

git log命令用来显示提交的快照. 能列出来你项目的历史, 能过滤和搜索你指定的一些修改. git status能让你检查工作目录和stage区的状态, git log只提供被commited到head的一些历史信息.

用法

git log

使用默认格式展示这个项目的commit历史. 如果输出超过一屏, 可以使用空格键来展示下一屏, 或者按q推出.

git log -n <limit>

限制只展示最近<limit>条commit历史.   如果<limit>为3那么只显示最近的3次commit历史.

git log --online

压缩每个commit到一行.

git log --stat

输出包括了git log的信息, 并且额外显示了哪些文件被修改了, 哪一行是新加的或者被删除了.

git log -p

有点类似于git log --state, 但是git log -p提供的信息更加详细, 他把修改的内容也给展现出来了.

git log --author="<pattern>"

搜索指定作者的commit. <pattern>可以是正则表达式.

git log --grep="<pattern>"

搜索commit描述匹配<pattern>的commit. <pattern>同样可以是正则表达式.

git log <since>..<until>

显示<since>到<until>之间的commit. <since>和<until>这两个参数可以是commit ID, branch名字, HEAD.

git log <file>

只显示指定文件的commit.

git log --graph --decorate -- online

这个非常用用. --graph会在最左边输出一个基于文本的符号(为了好看, 或者分类).

--decorate会把branch的名字和tag的名字也显示出来.

--online会把每个commit信息压缩成一行.

讨论

commit 3157ee3718e180a9476bf2e5cab8e3f1e78a73b7
Author: John Smith

第一行commit后面的40个字符是代表这一次commit的SHA-1校验码, 他是唯一的. 这个校验码有两个用途. 第一, 确保commit的完整--如果他被污染了, commit会生成一个不同的校验码. 第二, 作为commmit的一个唯一的ID号.

这个ID能在一些命令中使用, 例如git log <since>..<untile>（git log 3157e..5ab91）.

~符号用来表示一个相对于某个commit之前的相对位置的commit. 例如, 3157e~1表示在3157e之前的一个commit, HEAD~3表示当前commit之前的第三个commit.

例子

option可以组合使用.

git log --author="John Smith" -p hello.py

完整显示John Smith对hello.py这个文件所做的修改.

..符号可用于比较branch. 下面的例子展示了some-feature中有但是master中没有的commit

git log --oneline master..some-feature