答案是git的安全保护机制：目标分支含tracked同名文件，而当前工作区存在未跟踪（untracked）副本，为防数据丢失拒绝覆盖。常见于本地配置、日志、ide文件等，需用git clean -n预览后清理，或完善.gitignore规则。
git checkout 或 git switch 切换分支报 “Untracked working tree file … would be overwritten by merge”
这是 Git 在切换分支时发现：目标分支里存在某个文件（比如 config/local.env），而你当前工作区里恰好也有一个**未被 Git 跟踪**的同名文件（git status 显示为 untracked）。Git 拒绝覆盖，怕你丢数据。
本质不是“冲突”，而是 Git 的安全保护机制——它不信任你对未跟踪文件的处置权。
- 常见于本地生成的配置文件、日志目录（如
logs/）、编译产物（dist/）或 IDE 临时文件 - 注意：如果该文件在目标分支中是 tracked 的（即
git ls-tree -r target-branch | grep filename能查到），而你在当前分支没 add 过它，就一定会触发此提示 -
git stash对 untracked 文件默认无效（除非加-u）
用 git clean -n 确认哪些未跟踪文件会受影响
别急着删。先用 git clean -n -d 预览将被清除的全部未跟踪文件和目录（-n 表示 dry-run）。输出类似：
Would remove config/local.env Would remove logs/error.log Would remove dist/bundle.js
如果你确认这些文件都可丢（比如只是本地调试生成的），再执行 git clean -f -d；若只想清理特定文件，加路径，例如：git clean -f config/local.env。
-
-f是必须的，否则git clean拒绝执行 -
-d才能清理未跟踪目录；没有它，logs/这类空目录不会被列出来 - Windows 用户注意：
git clean -f在某些 Git for Windows 版本中需写成git clean -f -f（双-f）才能绕过额外确认
避免下次再踩坑：把不该跟踪的文件写进 .gitignore
这类问题反复出现，说明项目缺少合理的 .gitignore 规则。比如：
Conventional Commits v1.0.0 分支、工作树命名及提交信息规范，适用于 GitHub 与 GitLab 项目，用于创建分支和命名工作树等场景。
- 所有环境配置文件统一忽略：
config/*.env - 构建产物目录：
dist/、build/、target/ - IDE 文件：
.idea/、.vscode/、*.swp
加完规则后，如果文件已被 Git 跟踪（git ls-files | grep xxx 能查到），需先取消跟踪：git rm --cached config/local.env（不删物理文件），再 git commit。否则 .gitignore 对已跟踪文件无效。
临时绕过（不推荐但有时必须）：用 --force 或 --merge + --quiet
极少数场景下（比如 CI 脚本、临时调试），你明确知道可以覆盖且不想清理磁盘文件，可用：
-
git checkout --force feature/login（旧命令） -
git switch --force --discard-changes feature/login（新命令，更语义清晰）
⚠️ 注意：--force 不仅跳过 untracked 冲突检查，还会**丢弃所有本地修改（包括已暂存的）**，等价于硬重置工作区+索引。务必确认你不需要那些变更。
真正容易被忽略的是：Git 对“未跟踪文件”的判断基于整个仓库索引状态，而非当前分支快照。哪怕你在 A 分支删了 temp.txt，只要它曾被提交过、且 B 分支还保留着，切换回 B 时仍可能因本地残留的 untracked temp.txt 报错——因为 Git 认为“B 分支需要这个文件，而你有个没登记过的副本”。
