JDK的安装过程看似只是下载安装包然后一路点击下一步，但真正影响后续开发体验的，往往是安装路径的选择和环境变量的配置方式。实际工作中，不少项目构建失败、IDE无法识别JDK，根源都出在JAVA_HOME指向了bin目录，或者PATH里混入了多个不同版本的Java可执行文件。下面从版本选择、系统安装、环境变量和常见误区四个层面，把完整流程梳理清楚。
一、安装前如何选择JDK版本和发行版
下载JDK之前，先要分清Oracle JDK和OpenJDK。两者在核心代码层面高度一致，OpenJDK是完全开源免费的发行版，Oracle JDK在部分场景下对商业使用有授权要求。如果团队没有明确的Oracle支持需求，一般优先选择OpenJDK，可以从Adoptium、Microsoft Build of OpenJDK或Azul Zulu等渠道获取。这些发行版更新及时，安装包格式也覆盖Windows、Linux和macOS。
另外要关注版本号。Java每年3月和9月发布新特性版本，但只有部分版本被标记为LTS长期支持版本，例如Java 17和Java 21。生产环境更建议选择LTS版本，因为安全更新周期更长；本地开发和尝鲜则可以使用最新版本。下载页面通常提供x64、aarch64等不同架构，Windows用户多数选择x64 MSI或zip包，macOS用户根据芯片选择x64 dmg或aarch64 dmg，Linux服务器通常下载tar.gz包。安装前确认系统架构，能避免解压后运行不了的情况。
还有一点容易被忽略：安装路径最好提前规划。Windows默认路径是C:\Program Files\Java\jdk-版本号，这个路径包含空格，虽然JDK本身能正常工作，但部分旧版构建脚本、Hadoop相关工具或CI配置对空格敏感。建议在C盘或D盘根目录自建一个简单目录，例如C:\Java\jdk-21.0.5，后续配置环境变量也更直观。
二、Windows、Linux、macOS下的安装步骤
Windows下如果选择exe安装包，安装向导会询问JDK安装路径，建议把默认的C:\Program Files\Java\目录改成像C:\Java这样的自定义目录。安装完成后，JDK的bin目录里会出现java.exe、javac.exe、jar.exe等可执行文件。喜欢绿色安装的开发者也可以下载zip包，解压到目标目录即可，本质上和exe安装结果一致，卸载时直接删除目录更干净。
# Windows下使用zip包安装示例 # 下载jdk-21.0.5_windows-x64_bin.zip后解压到C:\Java # 解压后形成C:\Java\jdk-21.0.5目录 # 进入该目录查看版本 C:\Java\jdk-21.0.5\bin\java.exe -version
Linux服务器通常通过命令行操作。先下载对应架构的tar.gz包，使用tar命令解压，再移动到/usr/local/java目录下。移动完成后可以建立软链接，方便日后升级切换版本时不必修改所有配置。比如将jdk-21.0.5链接为/usr/local/java/current，环境变量统一指向current，升级时只需修改软链接目标。
# 解压JDK到/usr/local/java sudo mkdir -p /usr/local/java sudo tar -zxvf openjdk-21.0.5_linux-x64_bin.tar.gz -C /usr/local/java # 建立软链接 sudo ln -s /usr/local/java/jdk-21.0.5 /usr/local/java/current # 查看安装结果 /usr/local/java/current/bin/java -version
macOS用户可以选择dmg或pkg安装包，安装向导会把JDK放入/Library/Java/JavaVirtualMachines目录。通过/usr/libexec/java_home命令可以查看当前JDK的实际路径，这个命令在配置JAVA_HOME时非常有用。若同时安装了多个JDK版本，还可以通过/usr/libexec/java_home -v 21指定版本输出路径。
三、环境变量配置与验证方法
JDK安装完成后只是文件到位，命令行里直接输入java仍有可能找不到命令，这是因为系统还不知道去哪里查找可执行文件。Windows下的核心思路是设置JAVA_HOME指向JDK根目录，再把%JAVA_HOME%\bin追加到PATH变量。JAVA_HOME不是JDK自带的变量，而是很多开发工具会读取的约定变量，它的值绝对不要带上bin，否则Maven、Gradle等工具会拼出错误路径。
Windows设置环境变量可以在系统属性里操作，也可以使用命令行临时或永久设置。临时设置在关闭终端后失效，适合快速调试；永久设置推荐使用图形界面，因为setx命令直接修改PATH容易把原来的PATH覆盖或截断。下面给出临时验证用的命令，可以观察格式：
:: 临时设置当前终端环境变量 set JAVA_HOME=C:\Java\jdk-21.0.5 set PATH=%JAVA_HOME%\bin;%PATH% :: 验证java和javac命令 java -version javac -version
Linux和macOS的配置方式类似，都是通过export命令。将JDK路径写入用户主目录下的.bashrc或.zshrc文件，可以让每次打开终端都自动生效。注意PATH拼接时要引用已有PATH变量，避免把系统命令路径覆盖掉。配置完成后使用source命令重新加载配置文件，再执行java -version和javac -version，两者都能输出版本号说明JDK环境基本正常。
# 写入~/.bashrc export JAVA_HOME=/usr/local/java/current export PATH=$JAVA_HOME/bin:$PATH # 重新加载配置 source ~/.bashrc # 验证 java -version javac -version
还需要区分java与javac。有些用户只配置了java命令，编译代码时才发现javac不可用，这种情况通常是PATH里只添加了JRE路径或者只复制了java.exe。完整JDK的bin目录同时包含java、javac、jar等工具，确保PATH指向整个bin目录即可。
四、常见误区与注意事项
第一个误区是JAVA_HOME带bin。比如把JAVA_HOME设为C:\Java\jdk-21.0.5\bin，随后在PATH里又写%JAVA_HOME%\bin，实际展开后就变成了C:\Java\jdk-21.0.5\bin\bin，这个目录不存在，命令自然无法执行。正确做法是JAVA_HOME指向根目录，PATH单独追加%JAVA_HOME%\bin。下面这个错误示例可以帮助理解：
:: 错误示例：JAVA_HOME已经包含bin，再拼bin会导致路径错误 set JAVA_HOME=C:\Java\jdk-21.0.5\bin set PATH=%JAVA_HOME%\bin;%PATH% :: 展开后实际查找路径为 :: C:\Java\jdk-21.0.5\bin\bin\java.exe
第二个常见问题是PATH被覆盖。命令行使用set PATH=%JAVA_HOME%\bin会直接替换整个PATH，导致系统命令失效。图形界面编辑时要选择编辑文本或新建变量，而不是删除原有值。Linux下也要写成export PATH=$JAVA_HOME/bin:$PATH，保留$PATH部分。设置完成后一定要重新打开终端窗口，因为已经打开的会话不会自动刷新环境变量。
多版本JDK共存时，命令版本由PATH中匹配到的第一个java决定。排查版本混乱可以先执行where java或which java查看实际命中的可执行文件路径。如果显示的路径不是预期JDK，需要调整PATH顺序或删除旧版本残留。Windows用户还可以检查C:\Windows\System32目录下是否曾被某些软件放入java.exe，这个目录在PATH中的优先级通常很高，会干扰版本判断。
最后注意不要只安装JRE。JRE只包含运行Java程序所需的java命令，没有javac编译器和开发工具，无法完成编译任务。现在官方提供的JRE安装包已经很少，下载时需要看清文件名中是否包含JDK字样。安装完成后尽量用java -version和javac -version双重验证，而不是只查java，两个命令都能正确返回同一版本号时，开发环境才算是真正就绪。