最直接有效的Java开发环境重建方式是彻底清理旧配置并重装JDK、构建工具与IDE支持。需卸载所有JDK、删除残留目录、清空环境变量、验证java版本、使用SDKMAN!/jenv管理多版本、显式声明编译器源目标、重建Maven仓库及IDE索引，并交叉验证实际生效版本。
Java开发环境损坏后，最直接有效的重建方式不是逐项修复，而是彻底清理旧配置、重装JDK + 构建工具 + IDE支持，再按需恢复项目配置。手动“修复”往往遗漏隐性状态（如.m2/repository损坏、JAVA_HOME残留软链、IDE缓存混淆JDK版本），反而延长问题周期。
彻底卸载并清理JDK残留
系统级JDK残留是多数“明明重装了却还报错java.lang.UnsupportedClassVersionError”的根源。Windows/macOS/Linux处理逻辑不同，但核心动作一致：
- 卸载所有通过安装包安装的JDK（控制面板 / 系统偏好设置 /
sudo apt remove openjdk-*） - 手动删除残留目录：
/Library/Java/JavaVirtualMachines/（macOS）、C:\Program Files\Java\（Windows）、/usr/lib/jvm/（Linux） - 检查并清空环境变量：
JAVA_HOME必须指向新JDK根目录（如/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home），PATH中不能含旧JDK的bin路径 - 终端执行
which java和java -version确认输出与$JAVA_HOME/bin/java一致
用SDKMAN!或jenv管理多版本JDK（推荐）
手动切换JAVA_HOME易出错，尤其在Maven/Gradle构建时IDE与命令行版本不一致。SDKMAN!（Linux/macOS）或jenv（macOS）能隔离全局与项目级JDK：
- 安装SDKMAN!后执行
sdk install java 17.0.2-tem，再用sdk use java 17.0.2-tem临时切换 - 对Maven项目，在
pom.xml中显式声明maven.compiler.source和maven.compiler.target，避免依赖环境变量 - IntelliJ IDEA需在
File → Project Structure → Project和Modules两级分别指定SDK，仅设Project SDK不足以保证编译器行为
重建Maven本地仓库与IDE索引
~/.m2/repository损坏会导致依赖解析失败、类找不到、甚至mvn clean compile卡在下载阶段。不要尝试修复单个jar，应整体重建：
立即学习“Java免费学习笔记（深入）”；
- 重命名或删除
~/.m2/repository目录（Windows为%USERPROFILE%\.m2\repository） - 执行
mvn -U clean compile触发强制更新依赖（-U参数关键） - 在IDE中清除缓存：IntelliJ用
File → Invalidate Caches and Restart；VS Code需重启Java Extension并重新加载项目 - 若使用Maven Wrapper（
mvnw），确保.mvn/wrapper/maven-wrapper.properties中的distributionUrl指向稳定版本，避免因wrapper自身过期导致构建失败
真正耗时的从来不是重装动作本身，而是没意识到IDE的Project SDK、Module SDK、Language Level、Annotation Processors、Maven Importer设置是彼此独立的——改了一个，其余可能还在用旧JDK。每次重建后，务必用mvn help:system和IDE的“Show Compiler Output Path”交叉验证实际生效的Java版本。
