如何检查 Git 提交信息是否包含特定文本

简介

在本次实验中，你将学习如何在提交信息中高效搜索特定文本，从而在 Git 提交历史中查找相关内容。我们将探讨使用 git log --grep 命令根据关键词过滤提交，让你在大型项目中快速定位相关更改。

你还将学习如何使用 git show 查看通过搜索找到的特定提交的详细信息，以及如何使用 git log --grep 进行区分大小写的搜索以优化搜索结果。完成本次实验后，你将熟练掌握使用这些 Git 命令来浏览和理解项目历史。

Skills Graph

使用 git log --grep 进行搜索

在这一步中，你将学习如何使用 git log --grep 搜索提交历史。当你有大量提交记录，并且需要根据提交信息查找特定提交时，这个命令非常有用。

首先，让我们再进行几次提交，以便有更多内容可供搜索。我们将在 message.txt 文件中添加更多消息。

echo "Adding a second message." >> message.txt
git add message.txt
git commit -m "Add second message"

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

[master <commit-id>] Add second message
 1 file changed, 1 insertion(+)

现在，让我们再添加一条消息并提交：

echo "Adding a third message about the future." >> message.txt
git add message.txt
git commit -m "Add third message about future"

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

[master <commit-id>] Add third message about future
 1 file changed, 1 insertion(+)

现在，我们的提交历史中有三次提交。让我们使用 git log 查看所有提交：

git log --oneline

你应该会看到类似以下的内容（提交 ID 会有所不同）：

<commit-id> Add third message about future
<commit-id> Add second message
<commit-id> Send a message to the future

现在，假设我们想查找包含 "future" 的提交。我们可以使用 git log --grep 来实现：

git log --grep "future" --oneline

这个命令告诉 Git 只显示提交信息中包含 "future" 这个词的提交。你应该会看到类似以下的输出：

<commit-id> Add third message about future
<commit-id> Send a message to the future

注意，只有提交信息中包含 "future" 的提交才会显示出来。这是一种强大的过滤提交历史的方法，可以让你快速找到所需的内容。

--grep 选项允许你在提交信息中搜索特定模式。当你处理一个有大量提交的大型项目，并且需要查找与特定功能或 bug 修复相关的提交时，这个选项非常有用。

使用 git show 查看特定提交

在这一步中，你将学习如何使用 git show 命令查看特定提交的详细信息。该命令能让你确切了解某个提交引入了哪些更改。

首先，让我们获取首次提交的提交 ID。我们可以再次使用 git log --oneline 查看提交列表：

git log --oneline

查看输出，找到提交信息 "Send a message to the future"。复制简短的提交 ID（信息前面的字母和数字字符串）。它应该类似于 a1b2c3d。

现在，使用 git show 命令，后面跟上你复制的提交 ID。将 <commit-id> 替换为你实际复制的 ID：

git show <commit-id>

你应该会看到该特定提交的详细信息，包括：

• 提交 ID、作者、日期和提交信息。
• 该提交所做的更改。对于我们的首次提交，它将显示创建了 message.txt 文件，并添加了 "Hello, Future Me" 这一行。

输出将类似于以下内容（提交 ID 和日期会有所不同）：

commit <commit-id>
Author: Jane Doe <[email protected]>
Date:   Mon Aug 7 10:00:00 2023 +0000

    Send a message to the future

diff --git a/message.txt b/message.txt
new file mode 100644
index 0000000..e69de29
--- /dev/null
+++ b/message.txt
@@ -0,0 +1 @@
+Hello, Future Me

git show 命令对于理解项目历史非常有用。你可以使用它来确切了解任何提交中所做的更改，这对于调试或理解某个功能的实现方式至关重要。

你也可以不使用提交 ID 直接使用 git show 来查看最新提交的详细信息。试试看：

git show

这将显示提交 "Add third message about future" 的详细信息。

记住，你可以按 q 退出 git show 视图并返回命令行。

测试区分大小写的搜索

在这一步中，你将探究 git log --grep 如何处理大小写敏感问题。默认情况下，搜索是区分大小写的，这意味着 "future" 和 "Future" 是不同的。

让我们尝试使用 git log --grep 搜索 "Future"（首字母大写）：

git log --grep "Future" --oneline

根据我们之前的提交，只有第一条提交信息 "Send a message to the Future" 包含首字母大写的 "Future"。输出应该类似于以下内容：

<commit-id> Send a message to the future

注意，提交 "Add third message about future" 未被包含在内，因为它使用的是小写的 "f"。

现在，让我们再次尝试搜索 "future"（全部小写）：

git log --grep "future" --oneline

这次，包含 "future" 的两条提交（无论原始信息中的大小写如何）都应该显示出来：

<commit-id> Add third message about future
<commit-id> Send a message to the future

等等，这好像不对！上一步搜索 "future" 时显示了两条提交。这是因为在某些系统或配置中，git log --grep 的默认行为是不区分大小写的。

为了确保进行区分大小写的搜索，你可以使用 --i 选项（或 --ignore-case）。让我们尝试区分大小写地搜索 "Future"：

git log --grep "Future" --oneline --i

这个命令告诉 Git 在搜索时忽略大小写。现在，包含 "future" 或 "Future" 的两条提交都应该显示出来：

<commit-id> Add third message about future
<commit-id> Send a message to the future

这表明，虽然默认行为可能会有所不同，但显式使用 --i 选项会使搜索不区分大小写。如果你需要进行严格区分大小写的搜索，通常可以依赖不使用 --i 的默认行为。不过，鉴于可能存在的差异，了解用于不区分大小写搜索的 --i 选项是一个好习惯。

理解搜索中的大小写敏感性对于准确查找提交非常重要，特别是在提交信息约定可能不同的项目中。

总结

在本次实验中，你学习了如何有效地搜索 Git 提交历史。首先，你使用 git log --grep 基于提交信息中的特定文本过滤提交。这个强大的命令能让你快速定位相关提交，尤其在提交历史丰富的项目中。你通过创建多个提交，然后使用 --grep 查找包含 "future" 一词的提交来进行了实践。

你还探究了如何使用 git show 查看特定提交的详细信息，以及如何使用 git log --grep 进行区分大小写的搜索。这些技巧为你浏览和理解 Git 仓库的演变提供了重要工具。