.gitignore 背後發生了什麼事：Git 如何處理忽略的文件

Git 的 .gitignore 檔案：忽略檔案的幕後機制

引言

你是否曾好奇 Git 如何處理被忽略的文件，例如 <code>dist/</code> 目錄？本文將以一個 Python 專案為例，探討在 CI/CD 工作流程、複製和拉取程式碼庫等場景下，Git 對忽略檔案的處理方式。

Python 專案範例

典型專案結構

<code>my-python-project/
├── src/
│   └── my_package/
│       └── __init__.py
├── tests/
│   └── test_my_package.py
├── dist/
│   ├── my_package-1.0.0-py3-none-any.whl
│   └── my_package-1.0.0.tar.gz
├── .gitignore
├── setup.py
├── README.md
└── requirements.txt</code>

在 .gitignore 中忽略 dist/ 目錄

<code>dist/</code>

<code>dist/</code> 目錄通常包含打包過程中產生的建置產物（.whl、.tar.gz）。將這些檔案排除在版本控制之外，有助於保持程式碼庫的整潔。

---

為什麼要忽略 dist/ 目錄？

1. 管理程式碼庫大小

?️ 不忽略 <code>dist/</code> 目錄：

• 每次建置都會將建置產物新增至程式碼庫。
• 程式碼庫大小膨脹，導致克隆速度變慢。

? 忽略 <code>dist/</code> 目錄：

• 只追蹤原始碼。
• 程式碼庫保持精簡且有效率。

---

2. 避免衝突

⚠️ 不忽略 <code>dist/</code> 目錄：

• 對建置檔案的變更可能會導致不必要的合併衝突。
• 開發人員可能會推播過時或損壞的建置產物。

✅ 忽略 <code>dist/</code> 目錄：

• 建構產物在 CI/CD 或本地按需產生。
• 確保跨環境的一致性。

---

3. 提高 CI/CD 效率

? 不忽略 <code>dist/</code> 目錄：

• CI/CD 工作流程可能會使用已推送的過時建置產物。
• 可能會因為過時檔案而導致建置失敗。

? 忽略 <code>dist/</code> 目錄：

• CI/CD 動態產生建構產物，確保其新鮮度。
• 減少因過時文件而導致的錯誤。

---

忽略文件的常見場景

1. 推送變更

• 被忽略的檔案（例如 <code>dist/</code>）永遠不會被推送。
• 即使本地存在，Git 也會確保這些文件不會包含在提交中。

2. 克隆程式碼庫

• 如果 <code>dist/</code> 不存在：克隆過程中不會重新建立目錄。
• 如果 CI/CD 創建了 <code>dist/</code>：克隆會忽略它，因為它沒有被追蹤到程式碼庫中。

3. 拉取更改

• 被忽略的檔案在 git pull 期間不受影響。
• 如果目錄已存在於本機，則除非手動修改，否則它將保持不變。

4. CI/CD 工作流程

• CI/CD 管道會在建置過程中動態產生 <code>dist/</code> 目錄。
• 這些檔案是臨時的，通常在建置後清理以避免混亂。

---

忽略文件場景的視覺化總結

操作	行为
推送更改	忽略的文件永远不会被推送。
克隆代码库	忽略的文件不会被下载。
拉取更改	忽略的文件保持不变。
CI/CD 工作流	文件会被动态创建/删除。

---

管理忽略文件的最佳實務

• 保持 .gitignore 檔案更新: 定期檢查和調整模式以確保效率。
• 避免過度忽略: 確保沒有意外忽略任何重要文件。
• 使用建置工具產生建置產物: 使用 make、tox 或 CI/CD 管道等工具來動態產生檔案。
• 記錄模式: 在 .gitignore 中加入註解以解釋為什麼忽略某些文件。

以上是.gitignore 背後發生了什麼事：Git 如何處理忽略的文件的詳細內容。更多資訊請關注PHP中文網其他相關文章！