OSSEZ

 找回密码
 新用户

QQ登录

只需一步,快速开始

扫一扫,访问微社区

查看: 1082|回复: 0

[版本控制] Git 查看提交历史

[复制链接]
 楼主| 发表于 2015-3-29 11:50:31 | 显示全部楼层 |阅读模式
在提交了若干更新之后,又或者克隆了某个项目,想回顾下提交历史,可以使用 git log 命令查看。

接下来的例子会用我专门用于演示的 simplegit 项目,运行下面的命令获取该项目源代码:
  1. git clone git://github.com/schacon/simplegit-progit.git
复制代码


然后在此项目中运行 git log,应该会看到下面的输出:
  1. $ git log
  2. commit ca82a6dff817ec66f44342007202690a93763949
  3. Author: Scott Chacon <[email protected]>
  4. Date:   Mon Mar 17 21:52:11 2008 -0700

  5.     changed the version number

  6. commit 085bb3bcb608e1e8451d4b2432f8ecbe6306e7e7
  7. Author: Scott Chacon <[email protected]>
  8. Date:   Sat Mar 15 16:40:33 2008 -0700

  9.     removed unnecessary test code

  10. commit a11bef06a3f659402fe7563abf99ad00de2209e6
  11. Author: Scott Chacon <[email protected]>
  12. Date:   Sat Mar 15 10:31:28 2008 -0700

  13.     first commit
复制代码

默认不用任何参数的话,git log 会按提交时间列出所有的更新,最近的更新排在最上面。看到了吗,每次更新都有一个 SHA-1 校验和、作者的名字和电子邮件地址、提交时间,最后缩进一个段落显示提交说明。

git log 有许多选项可以帮助你搜寻感兴趣的提交,接下来我们介绍些最常用的。

我们常用 -p 选项展开显示每次提交的内容差异,用 -2 则仅显示最近的两次更新:

  1. $ git log -p -2
  2. commit ca82a6dff817ec66f44342007202690a93763949
  3. Author: Scott Chacon <[email protected]>
  4. Date:   Mon Mar 17 21:52:11 2008 -0700

  5.     changed the version number

  6. diff --git a/Rakefile b/Rakefile
  7. index a874b73..8f94139 100644
  8. --- a/Rakefile
  9. +++ b/Rakefile
  10. @@ -5,5 +5,5 @@ require 'rake/gempackagetask'
  11. spec = Gem::Specification.new do |s|
  12.      s.name      =   "simplegit"
  13. -    s.version   =   "0.1.0"
  14. +    s.version   =   "0.1.1"
  15.      s.author    =   "Scott Chacon"
  16.      s.email     =   "[email protected]

  17. commit 085bb3bcb608e1e8451d4b2432f8ecbe6306e7e7
  18. Author: Scott Chacon <[email protected]>
  19. Date:   Sat Mar 15 16:40:33 2008 -0700

  20.     removed unnecessary test code

  21. diff --git a/lib/simplegit.rb b/lib/simplegit.rb
  22. index a0a60ae..47c6340 100644
  23. --- a/lib/simplegit.rb
  24. +++ b/lib/simplegit.rb
  25. @@ -18,8 +18,3 @@ class SimpleGit
  26.      end

  27. end
  28. -
  29. -if $0 == __FILE__
  30. -  git = SimpleGit.new
  31. -  puts git.show
  32. -end
  33. \ No newline at end of file
复制代码


该选项除了显示基本信息之外,还在附带了每次 commit 的变化。当进行代码审查,或者快速浏览某个搭档提交的 commit 的变化的时候,这个参数就非常有用了。

某些时候,单词层面的对比,比行层面的对比,更加容易观察。Git 提供了 --word-diff 选项。我们可以将其添加到 git log -p 命令的后面,从而获取单词层面上的对比。在程序代码中进行单词层面的对比常常是没什么用的。不过当你需要在书籍、论文这种很大的文本文件上进行对比的时候,这个功能就显出用武之地了。下面是一个简单的例子:

  1. $ git log -U1 --word-diff
  2. commit ca82a6dff817ec66f44342007202690a93763949
  3. Author: Scott Chacon <[url=mailto:[email protected]][email protected][/url]>
  4. Date:   Mon Mar 17 21:52:11 2008 -0700

  5.     changed the version number

  6. diff --git a/Rakefile b/Rakefile
  7. index a874b73..8f94139 100644
  8. --- a/Rakefile
  9. +++ b/Rakefile
  10. @@ -7,3 +7,3 @@ spec = Gem::Specification.new do |s|
  11.     s.name      =   "simplegit"
  12.     s.version   =   [-"0.1.0"-]{+"0.1.1"+}
  13.     s.author    =   "Scott Chacon"
复制代码

如你所见,这里并没有平常看到的添加行或者删除行的信息。这里的对比显示在行间。新增加的单词被 {+ +} 括起来,被删除的单词被 [- -] 括起来。在进行单词层面的对比的时候,你可能希望上下文( context )行数从默认的 3 行,减为 1 行,那么可以使用 -U1 选项。上面的例子中,我们就使用了这个选项。

另外,git log 还提供了许多摘要选项可以用,比如 --stat,仅显示简要的增改行数统计:

  1. $ git log --stat
  2. commit ca82a6dff817ec66f44342007202690a93763949
  3. Author: Scott Chacon <[email protected]>
  4. Date:   Mon Mar 17 21:52:11 2008 -0700

  5.     changed the version number

  6. Rakefile |    2 +-
  7. 1 file changed, 1 insertion(+), 1 deletion(-)

  8. commit 085bb3bcb608e1e8451d4b2432f8ecbe6306e7e7
  9. Author: Scott Chacon <[email protected]>
  10. Date:   Sat Mar 15 16:40:33 2008 -0700

  11.     removed unnecessary test code

  12. lib/simplegit.rb |    5 -----
  13. 1 file changed, 5 deletions(-)

  14. commit a11bef06a3f659402fe7563abf99ad00de2209e6
  15. Author: Scott Chacon <[email protected]>
  16. Date:   Sat Mar 15 10:31:28 2008 -0700

  17.     first commit

  18. README           |    6 ++++++
  19. Rakefile         |   23 +++++++++++++++++++++++
  20. lib/simplegit.rb |   25 +++++++++++++++++++++++++
  21. 3 files changed, 54 insertions(+)
复制代码

每个提交都列出了修改过的文件,以及其中添加和移除的行数,并在最后列出所有增减行数小计。 还有个常用的 --pretty 选项,可以指定使用完全不同于默认格式的方式展示提交历史。比如用 oneline 将每个提交放在一行显示,这在提交数很大时非常有用。另外还有 short,full 和 fuller 可以用,展示的信息或多或少有些不同,请自己动手实践一下看看效果如何。

  1. $ git log --pretty=oneline
  2. ca82a6dff817ec66f44342007202690a93763949 changed the version number
  3. 085bb3bcb608e1e8451d4b2432f8ecbe6306e7e7 removed unnecessary test code
  4. a11bef06a3f659402fe7563abf99ad00de2209e6 first commit
复制代码


但最有意思的是 format,可以定制要显示的记录格式,这样的输出便于后期编程提取分析,像这样:
  1. $ git log --pretty=format:"%h - %an, %ar : %s"
  2. ca82a6d - Scott Chacon, 11 months ago : changed the version number
  3. 085bb3b - Scott Chacon, 11 months ago : removed unnecessary test code
  4. a11bef0 - Scott Chacon, 11 months ago : first commit
复制代码


表 2-1 列出了常用的格式占位符写法及其代表的意义。
%H提交对象(commit)的完整哈希字串
%h提交对象的简短哈希字串
%T树对象(tree)的完整哈希字串
%t树对象的简短哈希字串
%P父对象(parent)的完整哈希字串
%p父对象的简短哈希字串
%an作者(author)的名字
%ae作者的电子邮件地址
%ad作者修订日期(可以用 -date= 选项定制格式)
%ar作者修订日期,按多久以前的方式显示
%cn提交者(committer)的名字
%ce提交者的电子邮件地址
%cd提交日期
%cr提交日期,按多久以前的方式显示
%s提交说明


你一定奇怪作者(author)和提交者(committer)之间究竟有何差别,其实作者指的是实际作出修改的人,提交者指的是最后将此工作成果提交到仓库的人。所以,当你为某个项目发布补丁,然后某个核心成员将你的补丁并入项目时,你就是作者,而那个核心成员就是提交者。我们会在第五章再详细介绍两者之间的细微差别。

用 oneline 或 format 时结合 --graph 选项,可以看到开头多出一些 ASCII 字符串表示的简单图形,形象地展示了每个提交所在的分支及其分化衍合情况。在我们之前提到的 Grit 项目仓库中可以看到:
  1. $ git log --pretty=format:"%h %s" --graph
  2. * 2d3acf9 ignore errors from SIGCHLD on trap
  3. *  5e3ee11 Merge branch 'master' of git://github.com/dustin/grit
  4. |\
  5. | * 420eac9 Added a method for getting the current branch.
  6. * | 30e367c timeout code and tests
  7. * | 5a09431 add timeout protection to grit
  8. * | e1193f8 support for heads with slashes in them
  9. |/
  10. * d6016bc require time for xmlschema
  11. *  11d191e Merge branch 'defunkt' into local
复制代码

以上只是简单介绍了一些 git log 命令支持的选项。表 2-2 还列出了一些其他常用的选项及其释义。
[/tr]
选项说明[/td]
-p按补丁格式显示每个更新之间的差异。
--word-diff按 word diff 格式显示差异。
--stat显示每次更新的文件修改统计信息。
--shortstat只显示 --stat 中最后的行数修改添加移除统计。
--name-only仅在提交信息后显示已修改的文件清单。
--name-status显示新增、修改、删除的文件清单。
--abbrev-commit仅显示 SHA-1 的前几个字符,而非所有的 40 个字符。
--relative-date使用较短的相对时间显示(比如,“2 weeks ago”)。
--graph显示 ASCII 图形表示的分支合并历史。
--pretty使用其他格式显示历史提交信息。可用的选项包括 oneline,short,full,fuller 和 format(后跟指定格式)。
--oneline--pretty=oneline --abbrev-commit 的简化用法。


REF:http://cwiki.ossez.com/pages/viewpage.action?pageId=7045476
您需要登录后才可以回帖 登录 | 新用户

本版积分规则

关闭

站长推荐上一条 /1 下一条

QQ|手机版|小黑屋|Archiver|帮助|OSSEZ (North Tecom)  

GMT+8, 2021-3-1 20:34

Powered by Discuz! X3.2

© 2001-2013 Comsenz Inc.

快速回复 返回顶部 返回列表