jdk 21 安装后需正确配置 java_home 和 path 环境变量才能全局使用 java、javac 命令;windows 手动设置,macos/linux 编辑 shell 配置文件;java_home 指向 jdk 根目录,path 添加 %java_home%\bin(windows)或 $java_home/bin(macos/linux);验证需 echo java_home 和 java/javac -version 均成功。

JDK 21 安装后要让系统 anywhere 都能识别 java、javac 等命令,关键不是“装上就行”,而是正确配置两个核心环境变量:JAVA_HOME 和 Path。Windows 下必须手动设置,macOS/Linux 也需显式声明,否则命令行报错、IDE 找不到 JDK、Maven/Gradle 构建失败都是常见结果。
一、确认 JDK 已正确安装并记住路径
安装时务必避开中文、空格和特殊字符(如 C:\Program Files\Java\ 含空格,易出问题)。推荐路径示例:
- Windows:
D:\DevTools\jdk-21 - macOS:
/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home - Linux:
/usr/lib/jvm/jdk-21
安装完成后,进入该目录检查是否存在 bin/ 子文件夹,里面应有 java、javac、javadoc 等可执行文件——这是后续配置的依据。
你接手一个需求时,是不是经常这样:"改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续";这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境(JDK、Spring Boot、ORM、数据库、前端框架),记在
二、配置 JAVA_HOME(指向 JDK 根目录)
这个变量是 Java 生态的“锚点”,几乎所有开发工具(IDEA、Maven、Gradle、Tomcat、Spring Boot CLI)都依赖它定位 JDK。
- Windows:
- 打开【系统属性】→【高级】→【环境变量】
- 在【系统变量】区点击【新建】
- 变量名填
JAVA_HOME,变量值填你刚才记下的 JDK 根路径(例如D:\DevTools\jdk-21),不能带\bin
- macOS/Linux:
- 编辑
~/.zshrc(macOS Catalina 及以后默认)或~/.bashrc(旧版或 Linux) - 添加一行:
export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home(路径按实际调整) - 保存后运行
source ~/.zshrc生效
- 编辑
三、把 JDK 的 bin 目录加入系统 Path
只有这样,终端或 CMD 才能在任意位置直接调用 java 或 javac。
- Windows:
- 在【系统变量】中找到
Path,点击【编辑】→【新建】 - 输入
%JAVA_HOME%\bin(注意:不要重复添加C:\...\jdk-21\bin这类绝对路径,否则换 JDK 版本时要重配)
- 在【系统变量】中找到
- macOS/Linux:
- 在
~/.zshrc同一行追加:export PATH=$JAVA_HOME/bin:$PATH - 保存并
source ~/.zshrc
- 在
四、验证是否生效
打开全新终端(CMD/PowerShell/Terminal),依次执行:
-
echo %JAVA_HOME%(Windows)或echo $JAVA_HOME(macOS/Linux)→ 应输出你设的路径 -
java -version→ 显示java version "21.0.x"等信息 -
javac -version→ 显示javac 21.0.x
两项都成功,说明全局运行环境已就绪。若只 java 成功但 javac 报错,大概率是 Path 没加对 bin 目录;若两者都不行,优先检查 JAVA_HOME 路径是否拼写错误或指向了错误层级。
不复杂但容易忽略
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










