JAVA_HOME路径不能含空格或中文，因javac、java等工具启动时将其拼入命令行，Windows CMD以空格分隔参数导致路径被截断（如C:\Program Files\Java\jdk-21被切为C:\Program和Files\Java\jdk-21），引发error: invalid flag；中文路径则因JVM调用CreateProcessW时编码不一致，触发URISyntaxException或NoClassDefFoundError。
为什么JAVA_HOME里不能有空格或中文
因为javac、java、mvn、gradle这些工具在启动时，会把JAVA_HOME拼进命令行参数。Windows CMD 默认以空格分隔参数，没加引号的C:\Program Files\Java\jdk-21会被切成C:\Program和Files\Java\jdk-21两段——前半段当命令执行，后半段当非法参数，直接报error: invalid flag: Files\Java\jdk-21。
中文路径更麻烦：JVM底层调用CreateProcessW时，若路径含UTF-8以外编码（比如GBK），File.toURL()可能抛URISyntaxException；IDE读取rt.jar时路径解码失败，触发NoClassDefFoundError。
-
JAVA_HOME值必须是纯英文、无空格、无符号（如D:\Java\jdk-21） -
PATH中引用%JAVA_HOME%\bin也必须确保该路径本身干净 - IntelliJ 的
JRE Home配置项、Maven 的settings.xml里如果硬编码了 JDK 路径，同样要检查是否含中文或空格
安装时怎么选对路径
双击.exe安装包后，在“选择安装路径”页点击“更改”，手动输入目标路径——别依赖默认值，哪怕它看起来“很标准”。
- 推荐格式：
D:\Java\jdk-21、E:\dev\jdk17、C:\dev\jdk25 - 绝对避开：
C:\Program Files\Java（空格）、D:\我的开发工具\jdk（中文）、D:\Java JDK 21（空格+大小写混用） - 多版本共存？用数字或版本号区分：
D:\Java\jdk8、D:\Java\jdk11、D:\Java\jdk25，别用jdk-11.0.22这种带点号的长名（部分旧脚本解析异常）
JAVA_HOME配置错一个字符就全崩
设完路径后，别急着关窗口。打开命令行，逐条验证：
echo %JAVA_HOME%
输出必须和你安装目录**完全一致**，包括盘符大小写（D:不能写成d:）、末尾不带\（D:\Java\jdk-21\是错的，应为D:\Java\jdk-21）。
-
PATH里添加的是%JAVA_HOME%\bin，不是%JAVA_HOME%\jre\bin（JDK 自带 JRE，不需要单独配） - 改完环境变量后，**必须新开命令行窗口**，旧窗口不会自动刷新
%JAVA_HOME% - 验证命令：
java -version和javac -version输出版本号且无警告，才算真正生效
CI/CD 或 Docker 里路径出问题更难查
本地跑得通，流水线里javac突然返回错误码 1 且无日志？大概率是挂载路径或镜像内JAVA_HOME继承了宿主机的脏路径。
- Dockerfile 中写
ENV JAVA_HOME /opt/java/jdk-21，路径必须是容器内真实存在的、无空格无中文的绝对路径 - GitHub Actions 或 Jenkins 的
env块里设JAVA_HOME，值要和 runner 环境实际安装路径严格一致 - Gradle wrapper 启动时会读
org.gradle.java.home，如果这个值是相对路径或含空格，也会静默失败
最稳妥的做法：所有自动化流程里，JAVA_HOME都用硬编码的干净路径，而不是依赖系统变量推导。
