Git 版本及版本范围表示法

指定 revision
指定范围

很多 Git 命令都使用 revision（修订版本）作为参数。根据不同的命令，有时候 revision 参数代表一个特定的提交，有时候代表某一个提交可以追踪到的所有的父提交（比如 git log）。在后面的这种情况中，一般也可以提供一个版本范围作为参数。另外，有的命令（例如 git show）使用 revision 参数代表其他对象，如 blobs 或者 tree 对象。

指定 revision

一个 revision 参数 <rev> 在通常情况下（但并不是所有情况下）代表一个提交对象（commit）。使用一种称为扩展 SHA-1（extended SHA-1）的语法。下面是各种各样表示 revision 的语法。

<sha1>, e.g. dae86e1950b1277e545cee180551750029cfe735, dae86e

完整的 SHA-1 ID（40 字节的十六进制字符串），或者一个在仓库中可以唯一代表本次提交的前导子串都可以指代本次提交。在该例中，由于前导子串 dae86e 在仓库中是唯一的，所以可以使用 dae86e 来代表 dae86e1950b1277e545cee180551750029cfe735。如果 dae86e 在仓库中不是唯一的，只需要再多加几个字符，使之在仓库中唯一即可。
<describeOutput>, e.g. v1.7.4.2-679-g3bee7fb

git describe 命令的输出：包含一个 tag，后跟一个连字符，一个提交数目，一个连字符，一个字符 g，最后是一个简写的对象ID。
<refname>, e.g. master, heads/master, refs/heads/master

符号引用。例如：master 通常代表 refs/heads/master 引用指向的提交对象。如果你的仓库中同时存在 heads/master 和 tags/master，要想代表 master 分支，可以显式指定为： heads/master。如果一个引用名出现了二义性，那么 Git 按照下面的规则处理，使用找到的第一个匹配。
1. 如果存在 $GIT_DIR/<refname>，则使用之
2. 否则，查找 refs/<refname>
3. 否则，查找 refs/tags/<refname>
4. 否则，查找 refs/heads/<refname>
5. 否则，查找 refs/remotes/<refname>
6. 否则，查找 refs/remotes<refname>/HEAD
@：一个单独的 @ 代表 HEAD
<refname>@{<date>}, e.g. master@{yesterday}, HEAD@{5 minutes ago}

一个引用名，后跟一个 @ 符号，再后面是一个括在大括号里面的日期（例如：{yesterday}， {1 month 2 weeks 3 days 1 hour 1 second ago} 或者 {1979-02-26 18:30:00}）代表该引用在该段时间之前的值。这种用法只能用于引用上面，不能用于一个确切的 commit ID，并且该引用必须在 $GIT_DIR/logs/ 中存在有 log 记录。注意，这种用法只会查看你的本地仓库在给定时间点的状态。如果你要查看在某一时间段内的状态，请使用 --since 和 --until 参数。
<refname>@{<n>}, e.g. master@{1}

一个引用名后面跟着一个 @ 后缀，然后是括在大括号中的一个数字，例如（{1}，{15}）。可以代表该引用之前的第 n 个值。例如，master@{1} 代表 master 之前的值。而 master@{5} 则代表 master 之前第 5 次的值。这种用法只能用于引用上，并且该引用必须具有引用日志（$GIT_DIR/logs/<refname>）。
@{<n>}, e.g. @{1}

如果省略了引用部分，则代表当前分支。例如：如果你当前在分支 blabla 上，那么 @{1} 就和 blabla@{1} 是一个意思。
@{-<n>}, e.g. @{-1}

@{-}，这种表示法，代表之前第 n 次检出的分支或者提交。 qiandao
<rev>^, e.g. HEAD^, v1.5.1^0

在一个 revision 后面加上一个 ^ 后缀可以用来指代 revision 的直接父提交。^<n> 代表第 n 个父提交（例如， \<rev\>^ 和 \<rev\>^1 是等同的）。\<rev\>^0 代表 rev 自己。当 \<rev\> 是一个 tag 的名字时，\<rev\>^0 表示该 tag 对象对应的提交对象。
<rev>~<n>, e.g. master~3

在一个 revision 后面加上一个 ~<n> 后缀代表 revision 的第 n 个祖先提交。主要用户当 <rev> 有多个父提交的情况。
:/<text>, e.g. :/fix nasty bug

一个冒号，后跟一个斜杠，在后面是一串文本。这串文本会被当做正则表达式对待。整个 :/<text> 代表提交信息匹配正则表达式的最近一次提交。正则表达式可匹配提交信息的任何部分。如果要匹配提交信息的开头，可以使用 :/^foo。
<rev>:<path>, e.g. HEAD:README, :README, master:./README
:<n>:<path>, e.g. :0:README, :README

下面是一个图示，展示了各个概念：

G   H   I   J
 \ /     \ /
  D   E   F
   \  |  / \
    \ | /   |
     \|/    |
      B     C
       \   /
        \ /
         A
                       
A =      = A^0
B = A^   = A^1     = A~1
C = A^2  = A^2
D = A^^  = A^1^1   = A~2
E = B^2  = A^^2
F = B^3  = A^^3
G = A^^^ = A^1^1^1 = A~3
H = D^2  = B^^2    = A^^^2  = A~2^2
I = F^   = B^3^    = A^^3^
J = F^2  = B^3^2   = A^^3^2

指定范围

那些需要遍历历史提交的命令（如 git log）会对一系列的提交进行操作，而不是仅仅针对某一次提交。对于这些命令来说，如果只给它们提供一个 revision 参数，那么意思是指代沿着该 revision 的父提交链可以追踪到的所有提交。

如果要排除从某一次提交可以追踪到的提交，只需要在该提交的前面加上前缀 ^。例如： ^r1 r2 指代从 r2 可以追踪到的所有提交但是不包含从 r1 可以追踪到的所有提交。这种表示方法非常常见，因此对于 ^r1 r2 来说有一个简写表示法：r1..r2（注意：r1 与 r2 之间只有两个英文句点）。可以省略一个 revision，省略的 revision 默认是 HEAD。

相似的表示法：r1...r2 可以叫做 r1 和 r2 之间的差集（数学），就是指代从 r1 可以追踪到的提交或者是从 r2 可以追踪到的提交，但是不包含从 r1 和 r2 都可以追踪到的。

<rev>：代表从 <rev> 可以追踪到的提交（rev 的所有祖先）。
^<rev>：不包含从 <rev> 可以追踪到的提交。
<rev1>..<rev2>

包含从 <rev2> 可以追踪到的所有提交，但是不包含从 <rev1> 可以追踪到的提交。
<rev1>...<rev2>

包含从 <rev1> 或者 <rev2> 可以追踪到的提交，但是不包含从两者都可以追踪到的提交。这和上一种范围表示法容易混淆。上面的是两个点，而这个是三个点。举例说明，在上面的图示中，D..F 表示的提交范围只有F，而 D…F，表示的提交范围有 D 和 F。
<rev>^@, e.g. HEAD^@

代表 <rev> 所有的父提交，也就是从它的父提交可以追踪到的所有提交，但是不包含它自己。
<rev>^!, e.g. HEAD^!

下面是一些例子：

D                G H D
D F              G H I J D F
^G D             H D
^D B             E I J F B
B..C             C
B...C            G H D E B C
^D B C           E I J F B C
C                I J F C
C^@              I J F
C^!              C
F^! D            G H D F

Git 版本及版本范围表示法

指定 revision

指定范围

评论