如何解决切换Git分支时Java项目文件残留至其他分支的问题

问题复现 #

仅在Java项目中会遇到该问题，使用Intellij和Netbeans两款IDE时均会出现，使用的文件夹结构为课程要求规定，复现步骤如下：

• 新建空白Github仓库
• 执行mkdir classwork创建文件夹并添加README.md
• 执行mkdir summatives创建文件夹并添加README.md
• 创建branch-one分支
• 创建branch-two分支
• 将两个分支均推送至远程仓库
• 执行git checkout切换到branch-two分支
• 在classwork文件夹中新建HelloWorld Maven项目
• 执行add、commit操作后将改动推送至branch-two分支
• 执行git checkout切换回branch-one分支

问题表现 #

切换到本应仅存在两个空文件夹的branch-one分支后，classwork文件夹中仍然存在HelloWorld项目，有时项目无法访问、为空或仅存少量零散文件，而Github上的branch-one分支符合预期无多余文件。

根因分析 #

该问题是IDE文件锁、Git未跟踪文件处理逻辑共同导致的：

1. IDE文件锁定：Intellij、Netbeans运行时会锁定Java项目的编译输出目录（如target）、索引缓存、临时配置文件，Git切换分支时无法删除被锁定的文件，导致残留
2. 未跟踪文件未被Git管理：Maven项目中的IDE生成配置（.idea文件夹、iml文件、nbproject文件夹）、编译产物默认不在Git跟踪范围内，Git切换分支时不会处理未跟踪文件，这部分文件会留在工作区
3. 部分场景下提交时遗漏了部分项目文件，仅提交了部分代码，切换分支后已提交的文件被Git移除，未提交的文件残留，就会出现项目零散不全的情况

修复方案 #

临时清理残留 #

切换分支前先关闭IDE打开的项目，避免文件锁定。如果已经出现残留，确认当前分支没有未提交的需要保留的内容后，执行命令清理未跟踪文件：
git clean -fd

永久规避 #

1. 项目根目录补充完整的.gitignore规则，覆盖Java、Maven、两款IDE的自动生成文件，避免无关文件进入Git跟踪范围，也减少锁定冲突概率
2. 优先使用IDE内置的Git分支切换功能，不要在IDE打开项目的状态下直接在终端执行checkout操作，IDE内置功能会自动处理文件锁和同步逻辑
3. 提交改动前执行git status确认所有需要跟踪的项目文件都已被add，避免遗漏提交导致切换分支后文件不全

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