别让本地配置弄乱你的代码库：Git 忽略已追踪文件的终极指南
本文针对“如何在 Git 中忽略已被追踪的配置文件”这一痛点，详细对比了 skip-worktree、assume-unchanged 以及“配置模板法”三种解决方案，助你彻底解决本地数据库配置误提交的烦恼。
在日常开发中，我们经常遇到这样的尴尬：
项目里有一个已经被 Git 追踪的配置文件（如 config.yaml 或 application.properties），为了在本地运行，你必须把它改成连本地数据库。但在提交代码时，这些修改总是会出现在 git status 中，稍不留神就会把本地私密配置推送到远程仓库。
针对这个问题，这里有三种成熟的解决方案，按推荐程度排序如下。
方案一：最快解决 —— skip-worktree
如果你不想改动项目结构，只想快速让 Git “装作没看到”这个文件的修改，这是最推荐的方法。
操作步骤
- 标记忽略： 运行以下命令，告诉 Git 忽略该文件的本地修改。
git update-index --skip-worktree <path-to-your-file>
- 正常提交： 现在你修改该文件，
git status不会再提醒它有变动。 - 恢复追踪： 如果某次更新确实需要修改这个文件的结构并提交：
git update-index --no-skip-worktree <path-to-your-file>
方案二：容易混淆的 assume-unchanged
你可能在网上看到过 --assume-unchanged。虽然它也能隐藏修改，但其设计初衷是提升大文件的检查性能。
- 区别点： 如果你使用了
assume-unchanged，一旦远程仓库有人更新了该文件并被你pull下来，Git 会自动重置这个标志，你的本地修改又会重新出现。 - 适用场景： 仅用于性能优化，不建议用于长期维护本地差异化配置。
方案三：工程最佳实践 —— 配置文件模板化
从长远来看，最好的办法是不要把包含具体配置的文件放进 Git。
推荐工作流：
- 创建模板： 将现有的
config.js重命名为config.example.js，里面只留结构，不填真实账号密码。 - 提交模板： 将
config.example.js提交到仓库。 - 忽略真文件： 在
.gitignore中添加config.js。 - 本地分发： 团队成员
clone代码后，手动cp config.example.js config.js并填写自己的配置。
优点： 彻底隔离环境配置，零误操作风险，安全性最高。
总结与对比
| 特性 | skip-worktree |
assume-unchanged |
配置模板 + .gitignore |
|---|---|---|---|
| 推荐等级 | ⭐⭐⭐⭐ (快速方案) | ⭐⭐ | ⭐⭐⭐⭐⭐ (架构方案) |
| Pull 冲突处理 | 保持标记，可能需手动解决 | 自动失效，需重新设置 | 互不干扰，完全解耦 |
| 适用对象 | 已经入库的单个文件 | 大文件性能优化 | 新项目或大型工程 |
| 安全性 | 中（仍有误操作风险） | 低 | 高 |
下一步建议
如果你目前处于正在开发的项目中，建议立即对你的配置文件执行 git update-index --skip-worktree。如果是新启动的项目，请务必采用 方案三 的模板化思路。
