执行git update-index --skip-worktree后切换分支提示本地变更会被覆盖怎么办

报错根本原因 #

git update-index --skip-worktree 和 git update-index --assume-unchanged 的设计逻辑仅为：忽略本地对已跟踪文件的修改，不让变更出现在 git status 结果中、避免被误提交，完全不会绕过分支切换时的文件覆盖校验。如果目标分支中对应文件的版本与你本地修改后的版本存在差异，git 会正常触发覆盖拦截提示，避免你本地的变更丢失。
而 .git/info/exclude、.gitignore 仅对未纳入跟踪的文件生效，对已经被仓库跟踪的文件没有任何作用，所以修改这些配置无法解决问题。

对应解决方案 #

根据你本地修改的性质选择对应方案即可：

场景1：本地修改为临时内容，不需要长期保留

可以通过临时暂存修改的方式完成分支切换，操作步骤如下：

1. 先取消文件的 skip-worktree 标记：git update-index --no-skip-worktree <file-name>
2. 暂存该文件的本地修改：git stash push -m "临时本地修改" <file-name>
3. 正常切换目标分支：git switch master
4. 分支切换完成后，恢复之前的修改并重新添加标记：

   git stash pop
   git update-index --skip-worktree <file-name>
   

场景2：本地修改为长期需要保留的私有配置（如本地开发环境参数、私有密钥等）

这种场景不推荐使用 skip-worktree 类方案，稳定性差，推荐使用以下两种更稳妥的方案：

• 方案A：模板文件替代（可修改仓库结构时优先选）
  1. 将需要修改的文件从仓库跟踪列表中移除，加入 .gitignore：git rm --cached <file-name>，提交后推送到远端
  2. 在仓库中新增对应模板文件，如原文件为 config.py 就新增 config.example.py，写入通用配置
  3. 所有开发者本地将模板文件复制为原文件名，自行修改本地参数，该文件永远不会被提交，也不会触发分支切换冲突
• 方案B：自定义git过滤器（不可修改仓库结构时使用）
  仅本地生效，不会影响其他协作者，也不会触发切换分支报错：
  1. 在项目根目录执行命令，给目标文件绑定自定义过滤器：echo "<file-name> filter=localignore" >> .gitattributes
  2. 配置提交规则，提交时自动使用仓库原版内容，不会把本地修改提交上去：git config filter.localignore.clean "git show HEAD:%f"
  3. 配置检出规则，拉取/切换分支时自动保留本地修改：git config filter.localignore.smudge "cat"

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