切换 git 分支后 idea 编译报错“cannot find symbol”是因旧分支的 class 文件残留干扰，idea 的编译输出目录（如 out/ 或 target/）不会随 git 切换自动清理，vfs 索引可能滞后，导致仍引用已删除类的 .class 文件。
IDEA 切换 Git 分支后编译报错 java: cannot find symbol，不是代码写错了，而是旧分支的 class 文件残留干扰了新分支的编译路径。
为什么切换分支后 IDEA 还在找已删除的类？
IDEA 的编译输出目录（如 out/ 或 target/）不会随 Git 切换自动清理。A 分支存在 com.example.util.X，B 分支删掉了这个类，但 IDEA 仍从旧 .class 文件里尝试解析符号——结果就是“找不到”，哪怕源码里根本没引用它。
- Gradle/Maven 的构建产物是物理文件，不依赖 Git 状态，只认磁盘上有没有
.class - IDEA 的索引系统基于 VFS（虚拟文件系统），Git 切换时文件批量替换，但 VFS 事件可能丢失或延迟，导致索引与实际文件不一致
- Build System Bridge（Maven/Gradle Importer）不会主动触发 clean，除非你手动刷新并勾选 “auto-make” 或 “build project automatically”
最有效的三步清理法（非重启）
别急着点 “File → Invalidate Caches and Restart”，先试这组轻量操作，90% 场景能秒解：
- 执行
mvn clean或./gradlew clean：清空target/或build/目录，干掉所有旧 class - 在 IDEA 中右键项目 →
Reload project（Maven）或Refresh Gradle project：强制重建依赖图和模块结构 - 按
Ctrl+F9（Windows/Linux）或Cmd+F9（macOS）触发 “Make Project”：让 IDEA 重新扫描源码、生成新 class，而非复用缓存
注意：Build → Rebuild Project 虽然也 clean + build，但它会清掉整个 out/，比单独 mvn clean 更重，且可能触发不必要的 annotation processor 重跑。
如何避免下次再踩坑？
关键不是“每次切分支都手动 clean”，而是让构建行为与 Git 状态对齐：
- 在 IDEA 设置中启用
Build project automatically（Settings → Build → Compiler），配合Registry → compiler.automake.allow.when.app.running开启，让保存即编译，减少 stale class 积累 - 把
target/和out/加进.gitignore，确保它们永远不会被提交——否则不同分支的 class 文件可能互相污染 - 慎用
git stash后直接切分支：stash 恢复时若源码结构已变（比如包名重命名），IDEA 可能加载失败的 stub，引发跳转错乱；建议 stash 前先mvn clean
真正麻烦的从来不是缓存本身，而是缓存和 Git 工作树之间那几百毫秒的同步延迟——它不会报错，只会悄悄让你多花十分钟排查“明明没改代码为什么编译不过”。
