如何检查文件是否存在于 Git 仓库中

简介

在这个实验中，你将学习如何检查一个文件是否存在于 Git 仓库的历史记录中。我们将探讨两种主要方法：使用 git ls-tree 命令检查特定提交的内容，以及使用 git log 命令结合文件路径查看特定文件的历史记录。

通过实践练习，你将练习使用 git ls-tree 检查提交快照中存在的文件，并使用 git log -- <file> 验证文件的存在及其历史记录。我们还将使用不存在的文件测试这些方法，以了解它们的行为。

Skills Graph

运行 git ls-tree 检查文件

在这一步中，我们将探索如何使用 git ls-tree 命令查看 Git 的时间机器内部。这个命令能让我们查看特定提交的内容，就像在不完全打开密封时间胶囊的情况下查看其内部一样。

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

cd ~/project/my-time-machine

现在，让我们使用 git ls-tree 查看最新提交的内容。你需要提交 ID，你可以从 git log 的输出中获取。或者，你也可以使用 HEAD，它指的是最新提交。

git ls-tree HEAD

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

100644 blob a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9	message.txt

让我们来分析一下这个输出：

• 100644：这是文件模式，表示它是一个普通文件。
• blob：这表明它是 Git 中的“blob”对象，Git 就是用这种方式存储文件内容的。
• a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9：这是 blob 对象的唯一标识符（哈希值），代表了提交时 message.txt 文件的确切内容。
• message.txt：这是文件名。

git ls-tree 命令在不检出提交的情况下检查提交内容非常有用。它会显示特定时间点快照中的文件和目录。这与 git status 不同，git status 显示的是你的工作目录与最新提交相比的当前状态。

理解 git ls-tree 有助于你了解 Git 如何将项目历史存储为一系列快照，每个快照都有自己的一组文件和目录。

使用 git log -- <文件> 进行验证

在上一步中，我们使用 git ls-tree 查看了提交的内容。现在，让我们探索另一种方法，即通过 git log 结合文件路径来查看与特定文件相关的历史记录。

确保你仍处于项目目录中：

cd ~/project/my-time-machine

现在，让我们使用 git log 查看 message.txt 文件的历史记录：

git log -- message.txt

你应该会看到创建 message.txt 文件的提交的日志条目：

commit a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9 (HEAD -> master)
Author: Your Name <[email protected]>
Date:   Mon Aug 7 10:00:00 2023 +0000

    Send a message to the future

命令中的 -- message.txt 部分告诉 git log 仅显示影响 message.txt 文件的提交。当你有一个包含许多文件的大型项目，而你只想查看特定文件的历史记录时，这非常有用。

这个命令可以帮助你回答以下问题：

• 这个文件是什么时候创建的？
• 谁对这个文件做了最后一次更改？
• 在特定提交中，这个文件做了哪些更改？

随着项目的发展和提交次数的增加，使用 git log -- <文件> 对于理解项目中各个文件的历史和演变将变得至关重要。

按 q 退出日志视图。

测试不存在的文件

在前面的步骤中，我们成功使用 git ls-tree 和 git log -- <文件> 检查了 Git 仓库中存在的文件。现在，让我们看看当我们尝试对仓库历史中 不存在 的文件使用这些命令时会发生什么。

确保你处于项目目录中：

cd ~/project/my-time-machine

首先，让我们尝试对一个不存在的文件（例如 nonexistent.txt）使用 git ls-tree：

git ls-tree HEAD nonexistent.txt

你应该看不到任何输出。这是因为 git ls-tree 仅列出指定树（在这种情况下是 HEAD 处的树）中存在的条目。由于 nonexistent.txt 不在最新提交的树中，所以不会显示任何内容。

现在，让我们尝试对同一个不存在的文件使用 git log：

git log -- nonexistent.txt

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

fatal: no such path 'nonexistent.txt' in HEAD

这是不同的行为！git log -- <文件> 专门在整个历史记录中查找影响给定文件路径的提交。如果该文件路径从未在任何提交中存在过，Git 会告诉你“没有这样的路径”。

这种行为上的差异凸显了这些命令的工作方式：

• git ls-tree 检查 特定快照（提交）并列出其内容。
• git log -- <文件> 在 整个历史记录 中搜索与特定文件路径相关的更改。

理解这些差异有助于你为任务选择正确的命令。如果你想查看某个提交中有哪些文件，使用 git ls-tree。如果你想查看某个文件的历史记录，使用 git log -- <文件>。

总结

在本次实验中，我们学习了如何在不检出特定提交的情况下，检查文件是否存在于 Git 仓库的历史记录中。我们首先探索了 git ls-tree 命令，该命令使我们能够检查特定提交（如 HEAD）的内容，并查看文件及其对应的对象哈希值。此命令提供了仓库在特定时间点的快照，显示了文件模式、对象类型、对象 ID 和文件名。

然后，我们开始探索结合文件路径使用 git log 来查看与该文件相关的提交历史。这种方法使我们能够了解文件何时被添加、修改或删除，为我们提供了文件在仓库时间线中存在情况的不同视角。