13. 给版本打标签¶

目标¶

学习如何使用名称给提交打标签以供将来引用。

让我们称 hello 程序的当前版本为 version 1 (v1)。

标记 version 1¶

$ git tag v1

现在你可以引用程序的当前版本为 v1。

标记先前的版本¶

让我们标记当前版本之前的版本为 v1-beta。首先我们需要检出先前的版本。除了使用哈希值，我们可以使用 ^ 来表示“v1 的父提交”。

注意

如果使用 v1^ 表示法遇到问题，你还可以试试 v1~1，这将引用相同的版本。该表示法意为“v1 的第一个祖先提交”。

$ git checkout v1^
$ cat hello.rb

输出：

$ git checkout v1^
Note: checking out 'v1^'.

You are in 'detached HEAD' state. You can look around, make experimental
changes and commit them, and you can discard any commits you make in this
state without impacting any branches by performing another checkout.

If you want to create a new branch to retain commits you create, you may
do so (now or later) by using -b with the checkout command again. Example:

git checkout -b <new-branch-name>

HEAD is now at dc1d42f... Added a default value
$ cat hello.rb
name = ARGV.first || "World"

puts "Hello, #{name}!"

看，这是我们添加注释之前的默认值版本。让我们把它变成 v1-beta。

$ git tag v1-beta

按标签名检出¶

现在试试在两个标签版本之间切换。

$ git checkout v1
$ git checkout v1-beta

输出：

$ git checkout v1
Previous HEAD position was dc1d42f... Added a default value
HEAD is now at 4d578d4... Added a comment
$ git checkout v1-beta
Previous HEAD position was 4d578d4... Added a comment
HEAD is now at dc1d42f... Added a default value

使用 `tag` 命令查看标签¶

你可以使用 git tag 命令来查看可用的标签。

$ git tag

输出：

$ git tag
v1
v1-beta

查看日志中的标签¶

你也可以查看日志中的标签。

$ git hist master --all

输出：

$ git hist master --all
* 4d578d4 2019-11-01 | Added a comment (tag: v1, master) [Jim Weirich]
* dc1d42f 2019-11-01 | Added a default value (HEAD, tag: v1-beta) [Jim Weirich]
* 9a1c494 2019-11-01 | Using ARGV [Jim Weirich]
* 063b40e 2019-11-01 | First Commit [Jim Weirich]

你可以在日志输出中看到与分支名称（master）一起列出了两个标签（v1 和 v1-beta）。 HEAD 显示的是你当前检出的提交（此刻是 v1-beta）。