切换Git分支时如何保留被.gitignore忽略的本地文件？

未被Git跟踪、且已正确添加至.gitignore的文件本身不属于Git的版本控制范围，默认状态下切换分支时Git不会对这类文件执行删除、覆盖操作，直接正常切换分支即可保留。

如果遇到切换分支后目标文件消失的问题，可按以下方法排查处理：

• 确认忽略规则生效
  执行命令git check-ignore -v <目标文件/文件夹路径>，如果命令输出匹配的.gitignore规则，说明忽略配置已生效，此时直接执行普通切换分支命令即可，不要添加-f/--force强制切换参数，强制切换会清除未跟踪的文件：
  切换分支命令示例：

  git switch B
  # 或者使用旧版命令
  git checkout B
  

• 移除Git索引中的历史跟踪记录
  如果这些文件此前曾被提交到A分支的本地提交记录中，Git会仍然将其识别为跟踪文件，切换分支时会按分支版本覆盖文件。你可以在A分支执行以下命令，将文件从Git跟踪索引中移除（不会删除本地的实际文件）：
  处理单个文件：

  git rm --cached <你的文件名>
  

  处理整个文件夹：

  git rm --cached -r <你的文件夹名>
  

  操作完成后将本次修改提交到A分支，后续切换分支时Git就不会再操作这些文件。
• 同名文件冲突处理
  如果B分支中存在和你要保留的忽略文件同名的已跟踪文件，切换分支时会触发冲突提示。此时可以先将本地的忽略文件临时重命名，切换到B分支后再改回原名即可，这类文件属于Git忽略范围，重命名不会影响仓库的正常状态。

注意：不要随意执行git clean类命令，尤其是带-x参数的git clean -x会强制删除所有被忽略的未跟踪文件，可能导致你要保留的内容丢失。

内容的提问来源于stack exchange，提问作者Ali Bayat Mokhtari