卸载旧版JDK后残留PATH路径、注册表项或系统目录幽灵文件会导致java-version显示旧版本、IDE找不到新JDK、Maven编译失败；须先用where java/reg query（Windows）、java_home -V（macOS）等命令确认现状，再精准清理javapath、环境变量、注册表子项、安装目录及幽灵java.exe，最后新开终端验证java/javac版本一致且where java仅返回一条路径。
卸载旧版 JDK 后残留文件不清理，会导致 java -version 显示旧版本、IDE 找不到新 JDK、Maven 编译失败等问题。真正干扰系统的不是“删没删干净”，而是系统还在“认”它——比如 PATH 里还留着旧路径、注册表存着过期信息、或系统目录下藏着幽灵 java.exe。
先确认哪些 JDK 还在系统里
别凭记忆删，先摸清现状：
- Windows：用管理员命令提示符运行
where java（看所有可执行的java.exe路径）和reg query "HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft\JDK" /s（查注册表登记的 JDK 版本与 JavaHome） - macOS：终端运行
/usr/libexec/java_home -V查已注册 JDK，再ls /Library/Java/JavaVirtualMachines/看物理目录是否还存在 - Linux：用
dpkg -l | grep jdk（Debian/Ubuntu）或rpm -qa | grep java（RHEL/CentOS），再检查/usr/lib/jvm和/opt/java
重点清理三类“隐形残留”
这些地方不清，装了新 JDK 也白搭：
-
Oracle 自建的 javapath（仅 Windows）：路径是
C:\Program Files (x86)\Common Files\Oracle\Java\javapath，它会劫持java/javac命令。先从 PATH 中删掉该路径，再手动清空这个文件夹 -
环境变量中的硬编码路径：PATH 里所有类似
C:\Program Files\Java\jdk1.8.0_301\bin的条目都要删掉；JAVA_HOME 必须指向 JDK 根目录（如C:\Program Files\Java\jdk-21），不能带\bin，也不能指向已删除或不存在的路径 -
系统目录里的幽灵文件（仅 Windows）：有些安装器会把
java.exe、javaw.exe、javaws.exe拷进C:\Windows\System32或C:\Windows\SysWOW64，运行del "C:\Windows\System32\java*" /f /q和对应 SysWOW64 命令清除
注册表和安装目录要精准删
控制面板卸载只是第一步，残留注册表才是冲突主因：
立即学习“Java免费学习笔记（深入）”；
- 打开
regedit，只删以下两个路径中对应旧版本的子项（如1.8.0_381），不要删 JavaSoft 根节点：HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft\JDK\{版本号}HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft\Java Development Kit\{版本号} - 手动删安装目录：
C:\Program Files\Java\jdk-xx、C:\Program Files (x86)\Java\jdk-xx，以及用户目录下可能存在的便携版（如%USERPROFILE%\Downloads\jdk-8u301） - macOS 需额外清理：
/Library/Internet Plug-Ins/JavaAppletPlugin.plugin、/Library/PreferencePanes/JavaControlPanel.prefPane、~/Library/Application Support/Oracle/Java等用户级缓存
验证是否真干净
改完必须新开终端或命令行窗口验证：
- 运行
echo %JAVA_HOME%（Windows）或echo $JAVA_HOME（macOS/Linux），确认路径真实存在且指向新 JDK - 运行
java -version和javac -version，输出应一致且为新版本 - Windows 再跑一次
where java，只应返回一条路径（即%JAVA_HOME%\bin\java.exe） - macOS 运行
/usr/libexec/java_home -V，列表中不应出现已删版本
