如何检查 Git 分支是否包含特定提交

简介

在这个实验中，你将学习如何检查一个 Git 分支是否包含特定的提交。首先，你会探索 git log 命令及其过滤选项，以便根据提交信息内容或作者来搜索提交。接着，你将使用 git branch --contains 命令来高效地确定哪些分支包含特定的提交。最后，你将通过直接使用提交的哈希值来检查提交是否存在，以此验证你的发现。

Skills Graph

运行 git log 命令搜索提交

在这一步中，你将学习如何使用 git log 命令在项目历史记录中搜索特定的提交。随着项目的发展和提交次数的增加，git log 的输出可能会变得很长。Git 提供了强大的选项来过滤和搜索这些历史记录。

首先，确保你位于项目目录中：

cd ~/project/my-time-machine

现在，让我们再添加几个提交，以便有历史记录可供搜索。你将创建一个新文件，并对现有文件进行修改。

创建一个新文件：

echo "This is my second file." > second_file.txt

添加并提交新文件：

git add second_file.txt
git commit -m "Add a second file"

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

[master a1b2c3d] Add a second file
 1 file changed, 1 insertion(+)
 create mode 100644 second_file.txt

现在，修改 message.txt 文件：

echo "Adding another line." >> message.txt

添加并提交更改：

git add message.txt
git commit -m "Update message.txt"

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

[master e4f5g6h] Update message.txt
 1 file changed, 1 insertion(+)

现在你已经有了多个提交，让我们使用 git log 查看历史记录：

git log

你将看到列出的所有三个提交。按 q 退出日志视图。

要搜索提交消息中包含特定单词的提交，可以使用 --grep 选项。让我们搜索消息中包含 "message" 一词的提交：

git log --grep "message"

此命令将仅显示消息中包含 "message" 一词的提交。你应该会看到第一个和第三个提交。

你还可以使用 --author 选项按作者搜索提交。让我们搜索由 "Jane Doe"（在设置中配置的名称）所做的提交：

git log --author "Jane Doe"

这将显示由作者 "Jane Doe" 所做的所有提交。在这种情况下，应该会显示所有三个提交。

使用带有 --grep 和 --author 等选项的 git log 命令对于管理大型项目和查找特定更改或贡献至关重要。这就像是为你的项目历史记录配备了一个强大的搜索引擎！

使用 git branch --contains 检查提交

在这一步中，你将学习如何使用 git branch --contains 命令来找出哪些分支包含特定的提交。当你有多个分支，并且想知道某个特定更改存在于哪些分支时，这个命令非常有用。

首先，确保你位于项目目录中：

cd ~/project/my-time-machine

让我们创建一个新分支来演示这个命令。将其命名为 feature-branch：

git branch feature-branch

这个命令会创建一个新分支，但不会切换到该分支。你可以使用 git branch 命令查看你的分支：

git branch

你应该会看到类似以下的输出，其中 master 会被高亮显示（表示它是当前分支）：

* master
  feature-branch

现在，让我们获取第一个提交的哈希值。你可以使用 git log --oneline 命令查看包含提交哈希的精简日志：

git log --oneline

你会看到类似以下的输出（你的哈希值会不同）：

e4f5g6h (HEAD -> master) Update message.txt
a1b2c3d Add a second file
abcdef0 Send a message to the future

复制第一个提交（"Send a message to the future"）的哈希值。在上面的示例中，它是 abcdef0。

现在，使用第一个提交的哈希值运行 git branch --contains 命令：

git branch --contains abcdef0

将 abcdef0 替换为你第一个提交的实际哈希值。

输出应该会显示 master 和 feature-branch 两个分支：

* master
  feature-branch

这表明提交 "Send a message to the future" 同时存在于 master 和 feature-branch 分支上。这是合理的，因为你是在 master 分支上创建的 feature-branch，而第一个提交已经是 master 分支的一部分了。

现在，获取最后一个提交（"Update message.txt"）的哈希值。在上面的示例中，它是 e4f5g6h。

使用最后一个提交的哈希值运行 git branch --contains 命令：

git branch --contains e4f5g6h

将 e4f5g6h 替换为你最后一个提交的实际哈希值。

输出应该只显示 master 分支：

* master

这是因为最后一个提交是在创建 feature-branch 之后在 master 分支上进行的。因此，feature-branch 分支不包含这个提交。

git branch --contains 命令是理解提交和分支之间关系的强大工具，它能帮助你追踪特定更改被整合到了哪些分支。

使用提交哈希进行验证

在这一步中，你将练习使用提交哈希来引用项目历史中的特定时间点。Git 中的每个提交都有一个唯一的哈希，就像它的指纹一样。你可以使用这个哈希来查看特定提交的详细信息，甚至回到那个时间点。

首先，确保你位于项目目录中：

cd ~/project/my-time-machine

让我们再次查看提交日志以获取哈希值：

git log --oneline

你会看到类似以下的输出（你的哈希值会不同）：

e4f5g6h (HEAD -> master) Update message.txt
a1b2c3d Add a second file
abcdef0 Send a message to the future

现在，让我们使用第一个提交的哈希值查看其详细信息。复制第一个提交（"Send a message to the future"）的哈希值。在上面的示例中，它是 abcdef0。

使用 git show 命令，后面跟上提交哈希：

git show abcdef0

将 abcdef0 替换为你第一个提交的实际哈希值。

这个命令将显示该特定提交的详细信息，包括作者、日期、提交消息以及该提交引入的更改。你会看到 message.txt 文件是在这个提交中创建的。

按 q 退出 git show 视图。

现在，让我们查看第二个提交（"Add a second file"）的详细信息。从 git log --oneline 的输出中复制其哈希值。在上面的示例中，它是 a1b2c3d。

使用第二个提交的哈希值运行 git show 命令：

git show a1b2c3d

将 a1b2c3d 替换为你第二个提交的实际哈希值。

这将显示第二个提交的详细信息，其中 second_file.txt 文件是在这个提交中创建的。

最后，让我们查看最后一个提交（"Update message.txt"）的详细信息。复制其哈希值。在上面的示例中，它是 e4f5g6h。

使用最后一个提交的哈希值运行 git show 命令：

git show e4f5g6h

将 e4f5g6h 替换为你最后一个提交的实际哈希值。

这将显示最后一个提交的详细信息，其中在 message.txt 文件中添加了一行内容。

使用 git show 命令和提交哈希，你可以检查项目历史中任何特定提交的内容和更改。这对于调试、理解某个功能是如何实现的，或者只是回顾过去的工作都非常有用。

总结

在本次实验中，你学习了如何检查一个 Git 分支是否包含特定的提交。首先，你探索了 git log 命令及其过滤选项，例如使用 --grep 搜索提交消息，使用 --author 按作者搜索，从而在项目历史中定位提交。

接下来，你学习了如何使用 git branch --contains 命令直接检查一个分支是否包含特定的提交，最后，你通过使用提交哈希来验证这一点。