如何在 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 儲存庫。