如何解决Git切换分支时的未跟踪工作树文件覆盖错误？

问题根源 #

1. 你在develop分支生成的file.1/file.2/file.3是未追踪的工作区文件，但这些文件已存在于staging分支中，Git为避免覆盖本地未追踪文件，阻止分支切换。
2. 后续操作出现的newfile.xx add/add冲突，是因为本地staging分支与远程staging分支均新增了该文件，拉取时自动合并触发冲突。

场景1：需将构建生成的文件提交到staging分支（替换现有版本） #

按以下步骤操作，确保构建文件顺利替换并提交：

• 回到develop分支（若当前不在该分支）：
  git checkout develop
• 精准暂存构建生成的文件（避免误加其他文件）：
  git add file.1 file.2 file.3
• 将暂存内容存入stash：
  git stash push -m "stash build outputs"
• 切换至staging分支（此时工作区干净，无覆盖风险）：
  git checkout staging
• 拉取远程staging最新代码，同步本地分支：
  git pull origin staging
• 恢复stash中的构建文件，覆盖staging分支现有文件：
  git stash pop
• 提交并推送更新：
  git add file.1 file.2 file.3
git commit -m "update build files: file.1/2/3"
git push origin staging

场景2：构建文件为临时产物，无需提交到staging #

若这些文件只是本地临时生成，无需保留：

• 删除构建生成的文件：
  rm -rf file.1 file.2 file.3
• 切换至staging分支：
  git checkout staging
• 拉取远程最新代码，处理遗留冲突：
  git pull origin staging

解决newfile.xx的add/add冲突 #

若拉取时触发该冲突，手动处理步骤：

• 查看冲突文件内容：
  cat newfile.xx
• 编辑文件，删除冲突标记（<<<<<<< HEAD、=======、>>>>>>> origin/staging），保留需要的内容并保存。
• 标记冲突已解决：
  git add newfile.xx
• 完成合并提交：
  git commit（Git会自动生成合并提交信息，直接保存即可）

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