java_home必须指向jdk根目录(如c:\tools\jdk-25.0.3),不可含\bin后缀;path中添加%java_home%\bin或其绝对路径,并通过新开命令行执行java -version、javac -version和echo %java_home%三者验证。

JAVA_HOME必须指向JDK根目录,不能带\bin后缀
Windows下JAVA_HOME设成C:\Program Files\Java\jdk-25.0.3\bin是典型错误,会导致Maven、Gradle、IDEA等工具全部报“JAVA_HOME not defined correctly”。因为这些工具会基于JAVA_HOME去拼接$JAVA_HOME/lib/tools.jar(JDK 8)或$JAVA_HOME/lib/jrt-fs.jar(JDK 9+),路径错一级就找不到核心类库。
正确做法是让JAVA_HOME严格等于JDK解压/安装后的最外层目录,且该目录下必须同时存在bin、lib、jre(或conf)三个子目录。例如:
-
JAVA_HOME=C:\tools\jdk-25.0.3✅(根目录,无\bin) -
JAVA_HOME=C:\tools\jdk-25.0.3\bin❌(错在多了一级) -
JAVA_HOME=C:\Program Files\Java\jre1.8.0_301❌(这是JRE,不是JDK)
验证方式:命令行执行echo %JAVA_HOME%,再手动打开该路径,确认能直接看到bin文件夹。
Path里加%JAVA_HOME%\bin不生效?先关掉所有旧终端
改完环境变量后,在已打开的CMD或PowerShell里执行java -version仍报“'java' is not recognized”,不是配置错了,而是Windows不会动态刷新已运行进程的环境变量。旧窗口读的还是修改前的PATH快照。
必须关闭所有CMD、PowerShell、Git Bash,甚至IDE(如IntelliJ)的内置终端——它们通常不继承系统级环境变量变更。然后新开一个命令行窗口再试。
如果新开窗口仍不行,运行where java看是否返回%JAVA_HOME%\bin\java.exe。若返回空或指向C:\Program Files (x86)\Common Files\Oracle\Java\javapath\java.exe,说明PATH里混进了Oracle预装JRE的硬链接路径,得手动删掉那一行。
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式,或要求按照代码注释规范处理 Java 文件时,使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则,并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括:补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
为什么有些教程说要写死绝对路径到Path?
部分用户发现把%JAVA_HOME%\bin写进系统级Path后,重启电脑依然无效,根源是Windows系统变量对百分号变量的展开支持不稳定——尤其在某些Win10/Win11版本中,系统级Path里的%JAVA_HOME%可能根本不会被解析,变成一串无意义文字。
更稳妥的做法是:保留JAVA_HOME变量(供Maven、Tomcat等工具使用),但在Path中**直接填入JDK的完整bin路径**,例如:C:\tools\jdk-25.0.3\bin。这样绕过变量展开环节,100%可靠。
注意点:
- 不用加引号,即使路径含空格(
C:\Program Files\Java\jdk-25.0.3\bin完全合法) - 删掉Path里所有其他Java相关路径,避免多个
java.exe冲突 - 保持这一行在Path列表顶部,防止被旧JDK路径覆盖
javac -version报错但java -version正常?检查Path顺序和javac是否存在
这种现象说明java.exe能被找到,但javac.exe找不到,大概率是Path里只加了JRE的bin(比如Oracle JRE自带的C:\Program Files\Java\jre1.8.0_301\bin),而JRE里没有javac.exe。
运行where javac,如果返回空,就证实了这点。此时应:
- 确认
JAVA_HOME指向的是JDK而非JRE - 确认Path中
%JAVA_HOME%\bin或你填的绝对bin路径确实存在且拼写正确(注意是反斜杠\) - 进入该
bin目录手动查看是否存在javac.exe文件
OpenJDK 25的javac.exe一定在JDK根目录的bin下,不在jre\bin里——JDK 9+已移除独立JRE结构,jre子目录只是兼容性保留,实际运行时用的是bin同级的conf和lib。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










