JDK 17环境变量配置需确保JAVA_HOME指向JDK根目录(如/opt/jdk-17.0.1),PATH包含$JAVA_HOME/bin,优先使用/etc/profile.d/java.sh全局配置,并验证java -version、javac -version及echo $JAVA_HOME三者均正确。
系统提示 java: command not found 或 JAVA_HOME is not set,说明 JDK 17 没装好,或者环境变量没配对——不是“没装”,就是“装了但找不到”。关键不在下载多快,而在路径写对、变量生效、所有 shell 都认。
装错包或用错命令,后面全白忙。先跑两行:
cat /etc/os-release | grep -E "(NAME|VERSION_ID)"
uname -m
输出是 x86_64 就选 x64 包;如果是 aarch64(比如树莓派或新 Mac 服务器),必须下 ARM64 版本,否则解压后 java -version 会报 cannot execute binary file。
常见组合:
立即学习“Java免费学习笔记(深入)”;
apt install openjdk-17-jdk
dnf install java-17-openjdk-devel
yum install java-17-openjdk-devel,但注意仓库需启用 epel(sudo yum install epel-release)这是最常踩的坑。有人把 JAVA_HOME 设成 /opt/jdk-17.0.1/bin,结果 javac 能跑,但 Maven、Gradle、IDEA 全报找不到 tools.jar 或模块解析失败。
正确做法:
ls -F /opt/jdk-17.0.1/,确认有 bin/、lib/、jmods/ 等子目录JAVA_HOME 值只能是该目录本身,例如 /opt/jdk-17.0.1
which java 反推——它返回的是软链接目标,可能嵌套多层;稳妥方式是 readlink -f $(which java) | sed 's|/bin/java$||'
示例(假设解压到 /opt/jdk-17.0.1):
export JAVA_HOME=/opt/jdk-17.0.1<br>export PATH=$JAVA_HOME/bin:$PATH
全局配置文件里硬塞几行,升级系统或重装 shell 时容易被覆盖或冲突。/etc/profile.d/ 是专门放模块化环境变量的地方,以 .sh 结尾的脚本会被自动 source,且独立管理、互不干扰。
操作步骤:
sudo nano /etc/profile.d/java.shCLASSPATH 在 JDK 9+ 已基本弃用,不用配):export JAVA_HOME=/usr/lib/jvm/java-17export PATH=$JAVA_HOME/bin:$PATH
sudo chmod +x /etc/profile.d/java.sh(部分 shell 要求可执行权限)echo $JAVA_HOME 和 java -version
注意:如果之前在 ~/.bashrc 里也配过,优先级会覆盖系统级设置——测试时记得用全新登录 shell,或 su - $USER 切换,避免缓存干扰。
只跑 java -version 成功 ≠ 环境就 OK。还要检查:
javac -version:确认 JDK(非 JRE)完整安装,javac 在 bin/ 下但有些包管理器默认不装编译器echo $JAVA_HOME:值必须是非空、绝对路径、无拼写错误(比如写成 JAVA_HOEM)ls -l $JAVA_HOME/bin/java:确保文件存在且有执行权限(-rwxr-xr-x),否则可能是解压权限丢失或 SELinux 限制~/.bashrc,只认 /etc/profile.d/ 或显式 Environment= 设置如果 java -version 显示旧版本(比如 11),大概率是 PATH 里有老 JDK 路径排在前面,用 echo $PATH | tr ':' 'n' | grep jvm 查顺序,把新 JDK 的 $JAVA_HOME/bin 放最前。