Git如何忽略已追踪文件的变更？

当文件已经被Git追踪后，直接加到.gitignore确实不会生效——Git只会忽略未被追踪的文件。下面是几个可行的方案，按推荐程度排序：

方案1：使用模板文件（最佳实践） #

这是最稳妥的长期解决方案，既能保留默认配置，又能让每个开发者维护自己的本地配置：

• 第一步，把已追踪的配置文件重命名为模板文件（比如原文件是config.py，改成config.example.py）：

  mv config.py config.example.py
  

• 提交这个模板文件到仓库，替换原来的配置文件：

  git add config.example.py
  git commit -m "Replace tracked config with example template"
  

• 复制模板生成你的本地配置文件：

  cp config.example.py config.py
  

• 把本地配置文件（config.py）添加到.gitignore中：

  echo "config.py" >> .gitignore
  git add .gitignore
  git commit -m "Ignore local config file"
  

• 最后告诉团队里的其他开发者，拉取更新后执行cp config.example.py config.py来生成自己的本地配置。

这种方法的好处是新开发者能直接拿到默认配置模板，所有本地修改都不会被Git追踪，也不会影响仓库里的模板文件。

方案2：让Git暂时忽略本地变更（本地设置） #

如果你不想修改仓库结构，可以用Git的assume-unchanged或skip-worktree命令，让Git假装这个文件没有被修改：

方法A：git update-index --assume-unchanged #

适合临时忽略文件变更，比如你只是暂时修改了配置，不想提交：

git update-index --assume-unchanged path/to/your/config-file

如果之后想恢复追踪这个文件的变更，执行：

git update-index --no-assume-unchanged path/to/your/config-file

方法B：git update-index --skip-worktree #

更适合长期忽略，比如这个文件会被本地工具自动修改，你永远不想提交它的变更：

git update-index --skip-worktree path/to/your/config-file

恢复追踪的命令：

git update-index --no-skip-worktree path/to/your/config-file

⚠️ 注意：这两个命令都是本地设置，不会同步到远程仓库，每个开发者都需要自己执行一遍才能生效。如果之后仓库里的模板文件有更新，你需要先取消忽略，拉取更新，再重新设置忽略。

总结 #

• 推荐用方案1的模板文件方式，这是团队协作中最清晰、最不容易出问题的方案。
• 如果只是临时需求，或者不想改动仓库结构，可以用方案2的本地命令。

内容的提问来源于stack exchange，提问作者Eugen Konkov