如何在 Git 中添加空目录

---

Git 是一种流行的版本控制系统，它允许您管理源代码、跟踪更改并与他人协作。它还有助于您记录对代码库所做的每一次更改，包括创建新目录。但是，有时您可能需要向 Git 存储库添加空目录，这乍一看可能具有挑战性。在本文中，我们将探讨如何在 Git 中添加空目录。

什么是 Git 中的空目录？

在深入了解如何在 Git 中添加空目录之前，让我们首先了解什么是空目录。空目录是指不包含任何文件或子目录的目录。在 Git 中，目录称为“文件夹”，将空文件夹添加到存储库意味着创建一个其中没有任何文件的目录。

为什么要在 Git 中添加空目录？

您可能想知道为什么要将空目录添加到 Git 存储库。您可能需要添加空目录的原因有很多，包括：

• 组织您的项目 - 添加空目录可以帮助您通过为文件和目录创建逻辑结构来组织您的项目。

• 将来文件的占位符 - 有时，您可能希望为将来将要添加的文件创建目录。

• 项目约定 - 添加空目录可能是您的项目约定或构建系统的要求。

如何在 Git 中添加空目录？

现在我们已经对空目录是什么以及为什么要将其添加到存储库有了基本的了解，让我们探讨如何在 Git 中添加空目录。

方法 1：使用占位符文件创建空目录

在 Git 中创建空目录的一种方法是向该目录添加一个占位符文件。以下是操作步骤：

在您想要创建为空的目录中创建一个新文件。您可以使用 touch 命令创建一个空文件，例如：

$ touch path/to/new_directory/placeholder.txt

使用 git add 命令将文件添加到 Git 存储库：

$ git add path/to/new_directory/placeholder.txt

使用 git commit 命令提交更改：

$ git commit -m "Add new empty directory"

使用 rm 命令删除占位符文件：

$ rm path/to/new_directory/placeholder.txt

再次使用 git commit 命令提交更改：

$ git commit -m "Remove placeholder file"

通过创建占位符文件，您实际上是在创建空目录，并且一旦您提交了更改，就可以删除占位符文件，留下一个空目录。

方法 2：使用 .gitkeep 文件创建空目录

在 Git 中创建空目录的另一种方法是使用一个名为 .gitkeep 的特殊文件。此文件是一个空文件，您将其放置在您想要创建为空的目录中。以下是操作步骤：

使用 mkdir 命令在您的项目中创建一个新目录：

$ mkdir path/to/new_directory

使用 touch 命令在新目录中创建 .gitkeep 文件：

$ touch path/to/new_directory/.gitkeep

使用 git add 命令将 .gitkeep 文件添加到 Git 存储库：

$ git add path/to/new_directory/.gitkeep

使用 git commit 命令提交更改：

$ git commit -m "Add new empty directory"

通过添加 .gitkeep 文件，您告诉 Git 跟踪空目录，并且一旦您提交了更改，就可以将其推送到远程存储库。

方法 3：使用 --allow-empty-directory 标志

Git 2.28 及更高版本支持一个名为 --allow-empty-directory 的新标志，它允许您在不使用占位符文件或 .gitkeep 文件的情况下创建空目录。以下是操作步骤：

使用 mkdir 命令在您的项目中创建一个新目录：

$ mkdir path/to/new_directory

使用带有 --allow-empty-directory 标志的 git add 命令将空目录添加到 Git 存储库：

$ git add --allow-empty-directory path/to/new_directory

使用 git commit 命令提交更改：

$ git commit -m "Add new empty directory"

通过使用 --allow-empty-directory 标志，您告诉 Git 将空目录添加到您的存储库，并且一旦您提交了更改，就可以将其推送到远程存储库。

在 Git 中添加空目录时常见的问题

在 Git 中添加空目录看起来很简单，但您可能会遇到一些常见问题。

第一个问题是 Git 默认情况下不跟踪空目录。如果您创建一个空目录并尝试将其添加到 Git 存储库，Git 将忽略它。要克服此问题，您可以使用上面描述的方法向空目录添加占位符文件或 .gitkeep 文件。

第二个问题是 Git 可能不允许您提交空目录。如果您使用 --allow-empty-directory 标志添加了空目录，但该目录不存在于您的本地文件系统中，则可能会发生这种情况。要克服此问题，您需要在提交更改之前在本地文件系统上创建空目录。

第三个问题是，如果您删除了使用 .gitkeep 文件添加的空目录，Git 可能不会将其识别为目录，并且它不会从您的存储库中删除。要克服此问题，您需要在删除空目录之前手动删除 .gitkeep 文件。

其他提示和最佳实践

虽然在 Git 中添加空目录看起来像是一项简单的任务，但您应该牢记一些最佳实践和技巧，以确保您的存储库保持井井有条且易于管理。

保持存储库整洁

虽然空目录对于组织您的项目很有用，但务必保持存储库整洁，避免使用不必要的文件或目录将其弄乱。在添加空目录之前，请确保它是有必要的并且具有特定的用途。

使用描述性的目录名称

创建新目录时，务必使用反映目录内容的描述性名称。这可以帮助您和您的团队成员了解目录的目的，并更快地找到特定文件或目录。

使用 .gitignore 文件忽略不需要的文件

有时，您可能有一些不想包含在存储库中的文件或目录，例如构建工件或临时文件。在这些情况下，您可以使用 .gitignore 文件指定 Git 应忽略的文件或目录。

使用分支测试更改

如果您正在处理大型项目或进行重大更改，建议创建一个新分支来测试您的更改，然后再将其合并到主分支中。这可以帮助您避免冲突并确保您的更改按预期工作。

与您的团队协作

Git 是一个强大的协作工具，务必与您的团队成员紧密合作，以确保您的存储库保持井井有条且易于管理。确保团队中的每个人都了解添加空目录的最佳实践和指南，并共同努力保持存储库的整洁和组织。

结论

在本文中，我们探讨了如何使用不同的方法在 Git 中添加空目录。我们了解到创建占位符文件或 .gitkeep 文件是在 Git 中添加空目录的常用方法，我们还了解了 Git 2.28 中引入的 --allow-empty-directory 标志。我们还讨论了在添加空目录时可能遇到的一些常见问题以及如何克服它们。通过遵循本文中概述的步骤，您应该能够轻松地将空目录添加到 Git 存储库。