应选JDK 17或21 LTS版本,安装路径须无中文空格,严格配置JAVA_HOME和Path环境变量,并通过java -version、javac -version和echo %JAVA_HOME%三步验证。

装对 JDK 是 Java 开发的第一道门槛,不是点几下“下一步”就完事——关键在路径干净、变量准确、验证到位。下面直击重点,不绕弯子。
选对版本和安装包类型
优先用长期支持(LTS)版本,比如 JDK 17 或 JDK 21。JDK 21 是当前最新 LTS(免费商用,支持到 2026 年底),JDK 17 仍被大量企业项目采用,稳妥之选。
- 下载 OpenJDK 发行版更推荐:Eclipse Temurin(Adoptium)完全开源免费,镜像快、无捆绑,国内用清华 TUNA 镜像站即可
- 安装包选 x64 Installer(.exe),适合大多数 Windows 用户;若需自定义路径或避免管理员权限,可选 Compressed Archive(.zip),解压即用
- 别装 Oracle JDK 免费版以外的版本,容易踩授权或更新限制坑
安装时注意路径和细节
安装过程本身简单,但两处细节决定后续是否顺利:
- 路径不要含中文、空格或特殊符号,例如 D:\Java\jdk-21.0.2 比 C:\Program Files\Java\jdk 21 更可靠
- 记住这个完整路径,后面配置 JAVA_HOME 全靠它
- JDK 11 及以后版本不再单独安装 JRE,目录里看不到独立的 jre 文件夹是正常的,不用找、不用补
必须配全两个环境变量
只配 PATH 不配 JAVA_HOME,很多 IDE(如 IntelliJ、VS Code)和构建工具(Maven、Gradle)会识别失败。
在调试 Java 后端 API 故障时使用此技能,尤其适用于以下任务:分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转,以及生成简洁的诊断结论与修复方案。
立即学习“Java免费学习笔记(深入)”;
- JAVA_HOME:新建系统变量,变量名严格写成 JAVA_HOME(全大写、无空格),变量值填你记下的 JDK 安装路径,例如 D:\Java\jdk-21.0.2
- PATH:编辑系统变量 PATH,在末尾新增一项:%JAVA_HOME%\bin(注意是英文百分号,不是中文符号)
- 检查 PATH 里有没有中文顿号、全角分号、多余空格——这类字符是“javac 不是内部命令”的头号元凶
三步命令验证才算真正成功
打开新打开的命令提示符(旧窗口不生效),逐条执行:
- java -version → 看是否输出 OpenJDK 版本信息(确认运行环境 OK)
- javac -version → 看是否输出编译器版本(确认开发工具 OK)
- echo %JAVA_HOME% → 看是否打印出你设置的路径(确认变量本身没写错)
三项全通过,JDK 才算真正装好、能用。少一个,都可能在写代码或跑项目时突然卡住。

















