必须完成JDK安装与JAVA_HOME环境变量配置两件事:JAVA_HOME需指向JDK根目录(如C:\jdk-17,不含\bin),PATH须添加%JAVA_HOME%\bin以启用命令行工具,二者缺一不可,且路径禁用空格和中文。

要在Windows系统上让Java命令行工具可用、IDE能识别JDK、Maven能正常构建项目,必须完成JDK安装与JAVA_HOME环境变量配置两件事——只装不配,cmd里敲java -version会报“不是内部或外部命令”;只配不装,JAVA_HOME指向一个空目录,所有依赖它的工具都会直接失败。
下载并安装JDK
访问 Eclipse Temurin 官网 或 Oracle JDK 下载页,选择 x64 架构的 Windows Installer(.exe),优先选 LTS 版本如 JDK 17 或 JDK 21。不要选带“Demo”“Early Access”字样的预览版。
双击运行下载好的 .exe 文件,全程点“下一步”,但【务必取消勾选“Public JRE”安装选项】——这个组件已过时且与 JDK 内置 JRE 冗余,勾选后可能干扰 PATH 查找顺序。
安装路径必须避开空格和中文,强烈建议手动修改为 C:\jdk-17 或 C:\jdk-21。默认路径 C:\Program Files\Java\... 会导致后续 Maven、Gradle 等工具解析失败。
立即学习“Java免费学习笔记(深入)”;
设置 JAVA_HOME 系统变量
右键“此电脑” → “属性” → “高级系统设置” → “环境变量”。
在“系统变量”区域点击“新建”,变量名填 JAVA_HOME,变量值填你刚才记下的 JDK 根目录完整路径,例如:
C:\jdk-17
【注意:这里必须是 JDK 安装根目录,不能带 \bin,也不能是 \jre 子目录】——填错会导致 Maven 报“JAVA_HOME not found”,Android Studio 提示 SDK 路径无效。
将 JDK 命令加入系统 PATH
在同一个“环境变量”窗口中,找到“系统变量”里的 Path,点击“编辑” → “新建” → 输入:
%JAVA_HOME%\bin
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式,或要求按照代码注释规范处理 Java 文件时,使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则,并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括:补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
这一步让 cmd 和 PowerShell 能直接调用 java、javac、javadoc 等命令。不需要再单独添加 %JAVA_HOME%\jre\bin ——现代 JDK(8u291+ 及所有 JDK 11+)已移除独立 jre 目录,bin 下已包含全部可执行文件。
关闭所有已打开的命令行窗口,否则新环境变量不会生效。
验证配置是否成功
按 Win + R,输入 cmd,回车打开全新命令提示符。
依次执行以下三条命令:
echo %JAVA_HOME%
java -version
javac -version
第一行应精确输出你设置的路径(如 C:\jdk-17),后两行版本号必须一致且不为空。若 java -version 显示版本但 javac -version 报错,说明 PATH 没加对 %JAVA_HOME%\bin,只加了其他 Java 路径。

















