Windows需检查where java/javac路径、清理注册表JavaSoft项及JAVA_HOME目录;macOS要删JVM目录、更新shell配置并刷新java_home缓存;Linux建议用profile.d/java.sh配置;IDE须手动更新SDK和模块语言级别。

确认当前JDK安装路径和注册表残留(Windows)
Java卸载不干净常导致新版本无法识别或java -version仍显示旧版。Windows下不能只靠控制面板卸载——JDK安装器通常不会清理注册表项和系统环境变量,更不会动JAVA_HOME指向的旧目录。
- 先运行
where java和where javac查看可执行文件实际位置 - 检查注册表:
HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft\JDK和HKEY_LOCAL_MACHINE\SOFTWARE\JavaSoft\JRE,手动删掉对应旧版本键值(如17.0.1) - 删除物理目录,例如
C:\Program Files\Java\jdk-17.0.1,但别急着删C:\Program Files\Java\jre1.8.0_3XX——某些老应用可能直连它
macOS上彻底清除JDK(不只是删/Library/Java/JavaVirtualMachines)
macOS的JDK卸载容易误以为删掉/Library/Java/JavaVirtualMachines/jdk-17.jdk就完事,其实/usr/libexec/java_home -V仍可能缓存旧路径,且部分IDE(如IntelliJ)会读取~/.zshrc里硬编码的JAVA_HOME。
- 执行
sudo rm -rf /Library/Java/JavaVirtualMachines/jdk-17.jdk(替换为你实际的旧版本名) - 运行
/usr/libexec/java_home -V确认输出中已无该版本;若仍有,重启终端或执行source ~/.zshrc - 检查 shell 配置文件:
grep JAVA_HOME ~/.zshrc ~/.bash_profile,删掉或注释掉指向旧JDK的行,比如export JAVA_HOME=$(/usr/libexec/java_home -v 17)
Linux用tar.gz安装新JDK后PATH没生效?别漏掉profile.d
很多用户解压jdk-21.0.2_linux-x64_bin.tar.gz到/opt/jdk-21,再改/etc/profile,却忘了某些发行版(如Ubuntu Server)默认不读/etc/profile,而是依赖/etc/profile.d/下的脚本。
- 推荐做法:新建
/etc/profile.d/java.sh,内容为:export JAVA_HOME=/opt/jdk-21 export PATH=$JAVA_HOME/bin:$PATH
- 确保文件有执行权限:
sudo chmod +x /etc/profile.d/java.sh - 立即生效:
source /etc/profile.d/java.sh,再验证$JAVA_HOME和java -version - 注意:不要在
/etc/environment里写export——它不支持shell语法,只接受KEY=VALUE格式
IDE里JDK配置没更新?别只改Project SDK
即使系统级JDK已切换,IntelliJ或Eclipse仍可能沿用项目缓存的SDK路径,尤其当.idea/misc.xml或.project里硬编码了旧路径时,重装JDK本身不会触发IDE自动刷新。
立即学习“Java免费学习笔记(深入)”;
- IntelliJ:File → Project Structure → Project → Project SDK → 点击小齿轮 → Add JDK → 选新解压路径(如
/opt/jdk-21),再设为Project SDK - Eclipse:Preferences → Java → Installed JREs → Remove旧条目 → Add → Standard VM → Next → Directory选新JDK根目录
- 关键一步:检查模块编译级别是否同步——IntelliJ里Module Settings里的Language level可能还是
17,即使JDK已是21,需手动调高
JAVA_HOME,没清IDE缓存,或者macOS下忘了source配置,都会让java -version看起来“没变”。










