在IntelliJ中切换Git分支遇Untracked files阻止切换的问题咨询
2026-7-26
问题原因与解决方案：Untracked files prevent checkout 无法切回master分支
问题原因
你切换到旧版本分支后，该分支不存在master分支后续新增的那些文件，这些文件在旧分支的工作区中就变成了未被Git追踪的文件（untracked files）。Git默认会阻止分支切换操作，因为它担心切换到master时，这些未追踪文件会被覆盖或引发冲突——即便你没有修改任何内容，Git只关注当前工作区的文件状态是否干净。
安全切回master分支的方法
以下几种方式都不会破坏项目，可根据需求选择：
方式一：临时暂存未追踪文件（推荐）
- 执行命令：
git stash push -u
这个命令会把所有未追踪的文件（包括新增的文件）临时存入Git的stash栈，工作区会恢复到干净状态 - 执行
git checkout master即可正常切换分支 - 若之后需要恢复这些文件，执行
git stash pop就能把暂存的内容放回当前工作区
方式二：手动临时转移文件
- 将所有新增的未追踪文件复制到项目目录外的临时文件夹中
- 执行
git checkout master完成分支切换 - 若需要保留这些文件，再将它们移回项目目录即可
方式三：删除不需要的未追踪文件（谨慎操作）
如果确认这些未追踪文件在master分支中已经存在，且不需要保留本地副本：
- 执行命令：
git clean -fd
该命令会删除所有未被Git追踪的文件和空目录，执行前务必确认文件无保留价值，删除后无法恢复
内容的提问来源于stack exchange，提问作者kris82pl
相关产品推荐
相关产品推荐
