.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中文网其他相关文章！