JDK安装配置只需三步:下载安装包、执行安装、配置环境变量;新手应选JDK 17或21两个LTS版本,安装路径须无中文、空格,需正确设置JAVA_HOME和Path变量,并通过java -version与javac -version验证。

JDK 安装配置其实就三步:下载安装包、执行安装、配好环境变量。关键不是步骤多,而是每一步的细节容易出错,尤其路径和变量名必须严格准确。
选哪个 JDK 版本?
新手直接选 JDK 17 或 JDK 21 这两个长期支持(LTS)版本。它们稳定、资料多、兼容主流框架(如 Spring Boot 3 要求 JDK 17+)。避免选非 LTS 的最新版(比如 JDK 26),虽然新特性多,但部分工具或依赖可能还没适配,容易踩坑。
- JDK 17:适合入门、教学、中小项目,生态成熟
- JDK 21:适合新项目、想用虚拟线程等新特性的开发者,官方支持持续到 2026 年 9 月
- 安装路径别含中文、空格或特殊符号,推荐类似
D:\Java\jdk-21.0.1这样清晰干净的路径
安装 JDK 本身很简单
双击下载好的 .exe(Windows)或 .dmg(macOS)文件,一路点“下一步”即可。安装过程中注意记下最终的安装目录——这是后面配置环境变量唯一需要的信息。
- 安装时若出现勾选项(如 “Add to PATH” 或 “Set JAVA_HOME”),可勾上,但不建议完全依赖它,仍要手动核对环境变量是否正确
- 不要装在系统盘根目录(如
C:\jdk-21),也不要用带空格的路径(如C:\Program Files\...),否则后续 Maven、IDE 等工具容易报错
必须配的两个环境变量
打开「系统属性 → 高级 → 环境变量」,在「系统变量」区域操作:
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式,或要求按照代码注释规范处理 Java 文件时,使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则,并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括:补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
-
JAVA_HOME:新建变量,变量名必须是
JAVA_HOME(全大写,一个字母都不能错),变量值填你刚才记下的 JDK 安装完整路径,例如:D:\Java\jdk-21.0.1 -
Path:找到已有的
Path变量,点击编辑 → 新建 → 输入%JAVA_HOME%\bin(注意是百分号,不是引号)
这两项缺一不可:JAVA_HOME 是定位 JDK 的“地址簿”,Path 是让系统知道去哪找 java 和 javac 命令。
验证是否真的成功
关闭所有已打开的命令行窗口,重新打开一个新的 CMD 或终端,依次输入:
-
java -version→ 应显示 JDK 版本(如21.0.1) -
javac -version→ 应显示对应编译器版本(如21.0.1)
如果只显示 java 成功但 javac 报“不是内部或外部命令”,说明 Path 没加对 %JAVA_HOME%\bin,或者 JAVA_HOME 路径写错了;如果两个都报错,大概率是环境变量没生效(重启终端)或变量名拼写错误。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










