如何检查 Git 仓库中是否存在特定的提交哈希

简介

在这个实验中，你将学习如何检查一个 Git 仓库中是否存在特定的提交哈希 (commit hash)。我们将探索 git rev-parse 命令，它可以从短哈希或其他 Git 引用中获取完整的哈希，从而提供一种明确的方式来识别提交。

接下来，你将使用 git show 命令，通过提交的哈希来验证其是否存在并查看详细信息。最后，我们将介绍如何处理无效或不存在的提交哈希的情况。

Skills Graph

运行 git rev-parse 查看提交

在这一步中，你将学习如何使用 git rev-parse 命令来获取提交的完整哈希。当你需要项目历史中某个特定点的确切标识符时，这非常有用。

首先，确保你位于项目目录中。打开终端并导航到 my-time-machine 目录：

cd ~/project/my-time-machine

现在，使用 git log --oneline 命令获取最新提交的短哈希。该命令会显示提交历史的简洁视图。

git log --oneline

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

a1b2c3d (HEAD -> master) Send a message to the future

其中 a1b2c3d 部分是提交的短哈希。虽然这在日常使用中通常足够了，但有时你需要完整的唯一标识符。

这就是 git rev-parse 命令发挥作用的地方。你可以使用它从短哈希获取完整哈希。将 a1b2c3d 替换为你在 git log --oneline 输出中看到的短哈希：

git rev-parse a1b2c3d

你应该会在终端中看到完整哈希，类似于以下内容：

a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t

git rev-parse 是一个底层命令，常用于脚本编写。它可以解析各种类型的 Git 引用（如分支名、标签或短哈希），并输出相应的对象 ID（完整哈希）。

理解如何获取完整哈希非常重要，因为它提供了一种明确的方式来引用特定提交，而不受分支或标签移动的影响。

使用 git show 验证哈希

在上一步中，你学习了如何使用 git rev-parse 命令获取提交的完整哈希。现在，你将使用 git show 命令，通过提交的哈希来查看该特定提交的详细信息。

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

git show 命令用于显示各种类型的 Git 对象的信息，包括提交。当你向 git show 提供提交哈希时，它将显示提交消息、作者、日期以及该提交所引入的更改。

让我们使用上一步中获取的完整哈希来执行 git show 命令。将 a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t 替换为你实际的提交完整哈希：

git show a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t

你应该会看到类似以下的输出，显示你第一次提交的详细信息：

commit a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t
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..a1b2c3d
--- /dev/null
+++ b/message.txt
@@ -0,0 +1 @@
+Hello, Future Me

此输出确认了你使用的哈希对应于添加了内容为 "Hello, Future Me" 的 message.txt 文件的那次提交。

使用 git show 命令并结合提交哈希是检查项目历史的强大方法。你可以使用它来确切了解任何给定提交中所做的更改，这对于调试或理解项目的演变过程非常有价值。

请记住，你可以使用完整哈希，也可以使用足够长的哈希前缀（通常 7 个字符就足够了，但完整哈希始终保证是唯一的）来执行 git show 命令。

处理无效哈希

在前面的步骤中，你成功地将有效的提交哈希与 git rev-parse 和 git show 命令配合使用。但如果你提供了一个无效或不存在的哈希，会发生什么呢？当 Git 找不到你要查找的对象时，它会给出反馈。

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

让我们尝试使用一个不存在的哈希来执行 git show 命令。你只需输入一串看起来像哈希的随机字符：

git show deadbeef

你应该会看到类似以下的错误消息：

fatal: bad object deadbeef

这条消息表明 Git 找不到具有 deadbeef 哈希的对象（在这种情况下是一个提交）。这是 Git 在告诉你，你提供的引用在这个仓库中是无效的。

同样，如果你尝试使用无效的哈希来执行 git rev-parse 命令，也会得到一个错误：

git rev-parse invalidhash

输出会类似如下内容：

fatal: ambiguous argument 'invalidhash': unknown revision or path not in the working tree.
Use '--' to separate paths from revisions, like this:
'git <command> [<revision>...] -- [<file>...]'

这个错误消息更详细一些，它表明 Git 无法将 invalidhash 解释为已知的版本或文件路径。

理解这些错误消息很重要。当你遇到“bad object”或“unknown revision”错误时，通常意味着你尝试使用的提交哈希、分支名或标签在当前仓库的历史记录中不存在。请仔细检查你使用的哈希或引用，确保其正确无误。

这一步表明，Git 对所提供的引用要求很严格。使用有效的哈希对于准确地浏览和操作项目历史至关重要。

总结

在本次实验中，你学习了如何检查一个 Git 仓库中是否存在特定的提交哈希。首先，你使用 git rev-parse 命令从提交的短哈希获取其完整哈希，了解了该命令在解析 Git 引用和提供明确对象 ID 方面的作用。

接着，你探索了 git show 命令，通过提交的哈希来验证提交是否存在并查看其详细信息。这个过程能让你确认特定的提交是否存在于仓库的历史记录中。