git切换分支被阻止是因为未跟踪文件可能覆盖目标分支同名文件，安全做法是先运行git status -u查看具体干扰文件，再按需删除、stash或提交。

直接用 git checkout -f 最快，但会丢数据；真正安全的做法是先看清哪些文件在捣乱、再按需处理。

怎么看是哪些未跟踪文件挡路

错误信息里其实已经列出来了，但有时被终端刷屏盖住。最稳的方式是执行：

git status -u

它会明确把所有 Untracked files 单独归类显示。注意看输出里 “Untracked files:” 下面的列表，尤其是那些和目标分支同名的文件（比如 .idea/workspace.xml、config/local.example.json、README.md）——这些才是真正在阻止切换的“嫌疑人”。

常见干扰项包括：

One-click installation of GitHub projects

GInstall OneClick — 一键安装 GitHub 项目：规划、克隆、安装 Node 依赖、运行开发脚本。适用于想要获取 GitHubNode.js 项目的用户。

下载

• .idea/ 或 .vscode/ 下的配置文件（IDE 自动生成，通常该进 .gitignore）
• 本地调试生成的日志或缓存（如 logs/app.log、tmp/）
• 临时实验代码（如 test.py、draft.md）
• 团队新提交但你本地还没拉下来的配置文件（如 .env.local）

删、stash 还是加进版本库？选错就白忙

不能一概而论。关键看这个文件对当前工作流有没有实际价值：

• 如果是 IDE 自动生成的（.idea/modules.xml、.vscode/settings.json），确认已写入 .gitignore 后，可直接删——它们本就不该存在 Git 里
• 如果是你写的临时脚本或草稿（explore_api.js），又不确定要不要保留，用 git stash -u 更稳妥（-u 表示同时 stash 未跟踪文件）
• 如果是项目必需的新配置（比如 config/db.yaml），且其他同事也用了，那就该 git add + git commit，而不是绕开它
• 如果只是想快速切过去看一眼，且确定不要当前未跟踪文件的内容，git checkout -f 可行，但别养成习惯

IDEA 用户注意：图形界面操作暗藏坑

IDEA 的 Git 工具窗口（Alt+9）会把 Unversioned Files 单独列出来，看起来很友好，但容易误操作：

• 右键选 “Delete” 是物理删除，不可撤回；想留底就先手动复制一份
• “Rollback” 对未跟踪文件无效，它只对已跟踪但修改过的文件起作用
• 点右下角分支切换按钮弹出报错时，IDEA 默认不显示完整文件列表，得点错误框里的 “Show Details” 才能看到具体是哪几个文件
• 别手快点 “Don’t show again”，否则下次连警告都没了

最常被忽略的一点：很多开发者以为只要把文件加进 .gitignore 就万事大吉，其实 Git 不会自动清理已存在的未跟踪文件。加完 .gitignore 后，还得手动删掉那些已经生成的干扰项，否则下次切分支照样卡住。