Java JDK安装与环境变量配置详解_技术教程

Java -version报错主因是环境变量配置错误：Windows需正确设置JAVA_HOME指向JDK根目录且PATH包含%JAVA_HOME%\bin；Linux/macOS需匹配shell类型修改对应配置文件并source；IDE和构建工具需单独配置，不继承系统变量。

说明系统根本没识别到 JDK，问题出在环境变量没配对，或者配了但路径写错、没生效。Windows 下最常见的是：JAVA_HOME 指向了 JRE 目录而非 JDK 安装根目录，或者 PATH 里漏加了 %JAVA_HOME%\bin。

实操建议：

JAVA_HOME 必须指向 JDK 解压/安装后的根目录（如 C:\Program Files\Java\jdk-17.0.2），不能是里面的 jre 或 bin 子目录
PATH 中必须包含 %JAVA_HOME%\bin，且该条目要放在其他可能冲突的 Java 路径（如旧版 C:\Windows\System32\java.exe）之前
改完环境变量后，**必须新开一个命令行窗口**再测试，旧窗口不会自动刷新变量
用 echo %JAVA_HOME% 和 echo %PATH% 分别确认变量值是否符合预期

常因 shell 配置文件选错或未 source 导致。比如在 ~/.bashrc 里写了 export JAVA_HOME=...，但你用的是 zsh（macOS Catalina 及以后默认），那它就完全不会读这个文件。

实操建议：

先执行 echo $SHELL 确认当前 shell 类型（/bin/bash、/bin/zsh 等）
对应修改配置文件：~/.bashrc（bash）、~/.zshrc（zsh）、~/.profile（通用但优先级低）
配置完必须运行 source ~/.zshrc
（或对应文件），否则只对新终端生效
JAVA_HOME 值推荐用 $(dirname $(dirname $(readlink -f $(which javac))) 自动推导，避免硬编码路径出错

手动改 JAVA_HOME 和 PATH 太麻烦，也容易出错。关键是让 java、javac 命令实际指向的可执行文件能动态变更。

实操建议：

Windows：用 setx JAVA_HOME "C:\path\to\jdk-11" + 手动更新 PATH，或借助第三方工具如 jdk-switcher（非官方，需自行验证）
macOS/Linux：推荐用 update-alternatives（Debian/Ubuntu）或 archlinux-java（Arch），但更通用的是用 shell 函数封装切换逻辑

例如在 ~/.zshrc 中定义：

jdk() {
  export JAVA_HOME=$(/usr/libexec/java_home -v $1)
  export PATH=$JAVA_HOME/bin:$PATH
}

然后执行 jdk 17 即可切到 JDK 17

IDE 不读系统 JAVA_HOME，它用自己的 JDK 配置机制。即使命令行 java -version 正确，IDE 仍可能报“Project SDK is not defined”。

实操建议：

不要依赖“自动检测”，进入 File → Project Structure → Project → Project SDK，点 New → JDK，手动定位到 JDK 根目录（如 /Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home）
确保选中的是 jdk-xx 目录，而不是 jre 或 Contents/Home/jre
Maven/Gradle 项目还需检查 pom.xml 或 build.gradle 中的 java.version 是否与 IDE 设置一致，否则编译输出字节码版本会冲突
IntelliJ 新建项目时默认用 Bundled JDK（JetBrains Runtime），需手动改成系统 JDK 才能保证 javac 行为一致