彻底卸载旧JDK需手动清理残留：Windows删注册表和Program Files/Java；macOS用sudo rm -rf /Library/Java/JavaVirtualMachines/jdk-*.jdk；Linux用包管理器卸载并清空/usr/lib/jvm/等目录，再验证which java、echo $JAVA_HOME、java_home -V均为空后，再安装新JDK。
彻底卸载旧 JDK 并清空残留配置
Java 环境问题常源于旧版本残留，尤其是 JAVA_HOME、PATH 中指向已删除 JDK 的路径，或注册表（Windows）/ /Library/Java/JavaVirtualMachines/（macOS）中未清理的旧安装包。不手动清理就装新版本，java -version 可能仍显示旧版，javac 编译失败却报“找不到符号”，实际是用了错误的 rt.jar 或 tools.jar。
实操建议：
- Windows：用控制面板卸载所有 Oracle/OpenJDK 条目后，手动删掉
C:\Program Files\Java\下剩余文件夹，并检查注册表HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft\是否还存有旧项 - macOS：运行
sudo rm -rf /Library/Java/JavaVirtualMachines/jdk-*.jdk（注意通配符匹配），再确认/usr/libexec/java_home -V输出为空 - Linux：用包管理器卸载（如
sudo apt remove --purge openjdk-*），再手动清除/usr/lib/jvm/和~/.sdkman/candidates/java/（若用 sdkman）中的残留 - 全局搜索并清理
JAVA_HOME、PATH中所有含java或jdk的路径，尤其注意 shell 配置文件（~/.bashrc、~/.zshrc、/etc/profile）
验证系统是否真正“干净”再装新 JDK
很多人跳过这步，直接下载安装包双击运行，结果新 JDK 被装进旧路径，或被系统自动 symlink 到旧版本。真正的“干净”不是看有没有文件，而是看命令能否真实反映当前环境。
执行以下三步验证：
立即学习“Java免费学习笔记（深入）”；
- 关闭所有终端，新开一个，运行
which java、which javac—— 应该无输出；若有，说明PATH还没清干净 - 运行
echo $JAVA_HOME—— 必须为空；非空则说明环境变量残留 - 运行
/usr/libexec/java_home -V（macOS）或update-java-alternatives -l（Ubuntu）—— 应返回空或报错“no JVM installed”
只有全部通过，才开始下载新 JDK 安装包。推荐从 Eclipse Temurin 或 Amazon Corretto 获取，避免 Oracle JDK 的许可陷阱和捆绑软件。
安装后必须重设 JAVA_HOME 且避免硬编码路径
JAVA_HOME 写死成 /Library/Java/JavaVirtualMachines/jdk-17.0.1+12.jdk/Contents/Home 这类路径，下次升级就又得改；更糟的是 Windows 用户写成 C:\Program Files\Java\jdk-17，空格导致 Maven 报 Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin。
推荐做法：
- macOS：用
/usr/libexec/java_home -v 17动态获取路径，写入~/.zshrc：export JAVA_HOME=$(/usr/libexec/java_home -v 17)
- Linux（Temurin）：路径通常是
/opt/java/openjdk，但建议用readlink -f $(which java)上溯到bin的父目录，再设为JAVA_HOME - Windows：在系统变量里新建
JAVA_HOME，值设为C:\Program Files\Eclipse Adoptium\jdk-17.0.1+12-hotspot（注意用短路径名或确保无空格），并在PATH中用%JAVA_HOME%\bin引用
IDE 和构建工具需独立配置，不依赖系统 JAVA_HOME
IntelliJ IDEA、Eclipse、VS Code 的 Java 扩展、Maven、Gradle 都会缓存 JDK 路径。哪怕你系统里 JAVA_HOME 已更新，IDE 可能还在用旧 SDK，表现为：项目编译成功但运行时报 UnsupportedClassVersionError，或者 Lombok 注解不生效。
必须逐个检查：
- IntelliJ：File → Project Structure → Project → Project SDK → 点“+”重新添加，不要选“Detect”自动识别（它可能抓到旧路径）
- Maven：检查
~/.m2/settings.xml是否有<toolchain></toolchain>指向旧 JDK；运行mvn -version看输出的 Java 版本是否匹配预期 - Gradle：查看
gradle.properties是否含org.gradle.java.home，若有，确保其值与当前JAVA_HOME一致 - VS Code：打开 Command Palette（Ctrl+Shift+P），运行 “Java: Configure Java Runtime”，在 “Java Configuration Runtimes” 中移除旧条目
最隐蔽的坑是某些 IDE 插件（比如 Spring Boot Tools）自带嵌入式 JRE，它不走系统配置 —— 这类情况只能在插件设置里单独指定 JDK 路径。
