如何检查 Git 标签是否与分支关联

简介

在本次实验中，你将学习如何检查一个 Git 标签（tag）是否与特定分支相关联。我们将探索 git branch --contains 命令，以确定哪些分支包含标签所指向的提交。

你还将使用 git log 直观地验证标记提交是否存在于分支的历史记录中，并测试 git branch --contains 在不包含标记提交的分支上的行为。

Skills Graph

运行 git branch --contains 标签命令

在这一步中，我们将探索如何结合标签使用 git branch --contains 命令。该命令可用于找出哪些分支包含特定的提交，由于标签指向特定的提交，我们可以用它来查看哪些分支包含标签所指向的提交。

首先，确保你位于项目目录中。打开终端，如果你还未进入 my-time-machine 目录，请导航到该目录：

cd ~/project/my-time-machine

现在，让我们创建一个新文件并进行提交。这将为我们提供一个新的提交以供打标签。

echo "Another message for the future" > message2.txt
git add message2.txt
git commit -m "Add another message"

提交后，你应该会看到类似以下的输出：

[master a1b2c3d] Add another message
 1 file changed, 1 insertion(+)
 create mode 100644 message2.txt

现在，让我们为这个提交创建一个标签。我们将其命名为 v1.0。

git tag v1.0

此命令创建了一个名为 v1.0 的轻量级标签，指向当前提交。

要查看哪些分支包含 v1.0 标签所指向的提交，我们使用 git branch --contains 命令：

git branch --contains v1.0

由于我们只有 master 分支，并且标签是在 master 分支的最新提交上创建的，输出应该显示 master：

* master

星号 (*) 表示当前检出的分支。

这个命令非常强大，因为它能让你快速识别哪些分支已经纳入了由标签所代表的特定里程碑或版本。

使用 git log 验证分支

在这一步中，我们将使用 git log 命令直观地验证标签 v1.0 所指向的提交确实存在于 master 分支的历史记录中。虽然 git branch --contains 能告诉我们哪些分支包含某个提交，但 git log 能让我们详细查看提交历史。

确保你仍处于 ~/project/my-time-machine 目录中。

现在，让我们使用 git log 查看 master 分支的提交历史。我们可以使用 --decorate 选项来显示标签和分支指针。

git log --decorate --oneline

--oneline 选项提供简洁的视图，将每个提交显示在一行上。--decorate 选项会显示指向每个提交的引用（如分支名称和标签）。

你应该会看到类似以下的输出：

a1b2c3d (HEAD -> master, tag: v1.0) Add another message
e4f5g6h Send a message to the future

在这个输出中，你可以看到提交哈希（在这个例子中是 a1b2c3d），后面跟着提交信息。关键的是，在最新提交旁边，你应该会看到 (HEAD -> master, tag: v1.0)。这证实了 master 分支的最新提交与 v1.0 标签所指向的提交是同一个。

使用 git log 进行的这种直观验证补充了 git branch --contains 提供的信息。它有助于你理解项目历史中分支、标签和提交之间的关系。

请记住，git log 是探索项目时间线的强大工具。你可以使用各种选项来定制输出并找到你需要的信息。如果日志视图处于分页器中，按 q 退出。

测试不相关的分支

在这一步中，我们将创建一个新分支，并在该分支上进行一次提交，这次提交 不 基于 v1.0 标签所指向的提交。这将帮助我们了解 git branch --contains 命令在处理不包含指定提交的分支时的行为。

首先，让我们创建一个名为 feature-branch 的新分支。

git branch feature-branch

现在，让我们切换到这个新分支。

git checkout feature-branch

你应该会看到表明你已切换分支的输出：

Switched to branch 'feature-branch'

接下来，让我们在 feature-branch 上进行一次新的提交。我们将创建一个新文件。

echo "This is a new feature" > feature.txt
git add feature.txt
git commit -m "Add new feature file"

提交后，你应该会看到类似以下的输出：

[feature-branch a1b2c3d] Add new feature file
 1 file changed, 1 insertion(+)
 create mode 100644 feature.txt

现在，让我们再次使用 git branch --contains v1.0 命令。请记住，v1.0 指向 master 分支上的一个提交，而我们在 feature-branch 上的新提交与之不同。

git branch --contains v1.0

这次，输出应该只显示 master 分支：

master

feature-branch 未被列出，因为它不包含 v1.0 标签所指向的特定提交。这展示了 git branch --contains 如何准确识别哪些分支的历史记录中包含特定的提交。

当你想知道一个 bug 修复（用版本号打了标签）是否已包含在发布分支中，或者一个特定功能（也可能打了标签）是否已合并到不同的开发分支时，这个命令就非常有用。

总结

在本次实验中，我们学习了如何检查 Git 标签是否与某个分支相关联。我们首先使用了 git branch --contains <tag> 命令，该命令能有效识别包含指定标签所指向提交的分支。我们通过创建一个新提交、为其打标签，然后验证创建该标签的 master 分支是否被该命令列出，来演示了这一点。

接着，我们使用 git log 命令直观地确认了与标签关联的提交存在于分支的历史记录中，从而详细查看了提交的谱系。最后，我们探究了 git branch --contains 命令在处理不包含带标签提交的分支时的行为，进一步证明了它在快速确定特定带标签里程碑是否包含在分支中的实用性。