如何检查文件是否属于特定分支

简介

在这个实验中，你将学习如何在不切换到特定 Git 分支的情况下，检查该分支中是否存在某个特定文件。我们将探讨两种主要方法：使用 git ls-tree 命令检查分支的树对象内容，以及使用 git log 命令查看特定分支上某个文件的提交历史。你将通过创建一个新分支、添加一个文件，然后从另一个分支验证该文件是否存在来练习这些技术。最后，你将应用这些方法来测试其他分支中是否存在文件。

Skills Graph

运行 git ls-tree 查看分支文件

在这一步中，我们将探讨如何使用 git ls-tree 命令查看 Git 仓库中特定分支和文件的内容。这个命令有助于在不实际检出特定分支的情况下，查看项目在历史特定时间点或不同分支上的状态。

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

cd ~/project/my-time-machine

现在，创建一个名为 feature-branch 的新分支并切换到该分支。我们将在那里添加一个新文件。

git branch feature-branch
git checkout 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

现在，你有了一个新分支 feature-branch，其中包含一个 master 分支上不存在的文件 feature.txt。

让我们切换回 master 分支。

git checkout master

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

Switched to branch 'master'

注意，由于你现在处于 master 分支，feature.txt 文件在当前目录中不再可见。

现在，使用 git ls-tree 从 master 分支查看 feature-branch 的内容，特别是 feature.txt 文件，而无需切换回去。

git ls-tree 的基本语法是 git ls-tree <tree-ish> <path>。<tree-ish> 可以是分支名、提交哈希或标签。<path> 是你要查看的文件或目录的路径。

要查看 feature-branch 根目录的内容，可以使用以下命令：

git ls-tree feature-branch

你应该会看到类似以下的输出，显示 feature-branch 根目录中的文件：

100644 blob a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9	feature.txt
100644 blob f9e8d7c6b5a4938271605f4e3d2c1b0a98765432	message.txt

此输出显示了文件模式、对象类型（文件为 blob）、对象哈希和文件名。

要查看 feature-branch 上特定文件（如 feature.txt）的详细信息，可以使用以下命令：

git ls-tree feature-branch feature.txt

你应该会看到类似以下的输出，专门针对 feature.txt：

100644 blob a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9	feature.txt

这个命令使你能够查看其他分支或过去的提交，了解特定文件的状态，而无需更改当前工作目录。这在比较分支间的文件或查看历史版本时非常有用。

使用 git log <分支名> -- <文件名>

在这一步中，你将学习如何使用带有 -- 分隔符的 git log 命令，查看特定分支上某个文件的提交历史。当你想了解单个文件随时间的变化情况，而不考虑当前所在分支时，这个方法非常有用。

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

cd ~/project/my-time-machine

你当前位于 master 分支。让我们查看该分支上 message.txt 文件的提交历史。

git log -- message.txt

你应该能看到 message.txt 的提交历史。由于在 master 分支上，我们只进行了一次包含该文件的提交（初始提交），输出会类似如下内容：

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

    Send a message to the future

按 q 退出日志查看界面。

现在，让我们查看 feature-branch 分支上 feature.txt 文件的提交历史。记住，你仍然在 master 分支上，但可以查看另一个分支上文件的历史。

语法是 git log <分支名> -- <文件路径>。

git log feature-branch -- feature.txt

你应该能看到 feature-branch 分支上 feature.txt 的提交历史。这将显示你添加 feature.txt 文件的那次提交：

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

    Add new feature file

按 q 退出日志查看界面。

-- 分隔符很重要。它告诉 Git，后面的参数是文件路径，而不是分支或其他引用。这样你就能准确指定要查看哪个文件的历史。

这个命令对于理解项目特定部分的演变非常强大。如果你想弄清楚某行代码是何时添加或修改的，git log -- <文件> 会是你的好帮手。你甚至可以添加 -p 等选项，查看该文件每次提交所做的实际更改。

查看其他分支中的文件

在这一步中，你将练习在不切换当前分支的情况下，访问和查看不同分支中文件的内容。当你需要比较文件的不同版本，或者快速查看另一个分支中的内容时，这是一项非常常见的操作。

确保你位于项目目录中：

cd ~/project/my-time-machine

你当前位于 master 分支。让我们确认一下：

git branch

输出应该显示 * master，表明你正在 master 分支上。

  feature-branch
* master

现在，让我们尝试查看仅存在于 feature-branch 分支中的 feature.txt 文件的内容。你可以使用 git show 命令来完成此操作。git show 命令通常用于显示 Git 中的各种对象，包括特定提交或分支中文件的内容。

查看另一个分支中文件的语法是 git show <分支名>:<文件路径>。

git show feature-branch:feature.txt

你应该会看到 feature-branch 分支中 feature.txt 文件的内容：

This is a new feature.

这非常方便！你无需切换分支就能查看文件内容。

现在，让我们尝试查看 feature-branch 分支中 message.txt 文件的内容。这个文件在两个分支中都存在，但如果在 feature-branch 分支中对其进行了修改，内容可能会有所不同。在我们的示例中，其内容与 master 分支中的相同。

git show feature-branch:message.txt

你应该会看到 feature-branch 分支中 message.txt 文件的内容：

Hello, Future Me

这展示了你如何使用 git show 命令访问仓库中任何分支或提交中的文件。这是一种强大的技术，可用于比较文件版本、通过查看过去的状态来调试问题，或者在不影响当前工作的情况下查看其他分支中的代码。

能够快速查看其他分支或提交中的文件是一项很有价值的技能，它可以节省你的时间，并帮助你更有效地了解项目的历史和状态。

总结

在本次实验中，你学习了如何检查一个文件是否属于 Git 中的特定分支。首先，你使用 git ls-tree 命令查看分支的内容以及该分支内的特定文件，而无需检出该分支。这包括创建一个新分支、向其中添加文件、切换回原分支，然后使用带有分支名称和文件路径的 git ls-tree 命令来检查文件在另一个分支上的存在情况和详细信息。这种方法提供了一种快速查看文件是否存在于不同分支以及其关联的对象哈希（blob hash）的方式。