安装JDK时必须使用纯英文路径，避免中文、空格和括号，否则因Windows默认GBK与JDK默认UTF-8编码不一致，会导致NoClassDefFoundError、资源加载失败等问题。
直接把JDK装在含中文的路径里，后续大概率会出问题——不是报错就是资源加载失败，而且排查起来特别绕。最省事的办法，是安装时就避开中文路径。
为什么中文路径会让Java环境“失灵”
Windows默认用GBK编码解析命令行路径，而JDK内部（尤其是ClassLoader、ResourceBundle、File API）默认按UTF-8处理字符串。两者不匹配，就会出现：java.lang.NoClassDefFoundError、FileNotFoundException、控制台输出乱码、Maven打包时找不到src/main/resources里的中文命名配置文件等现象。
这不是Java本身bug，而是整个工具链（cmd、IDE、Maven、JVM启动参数）对编码的默认行为没对齐。
- IDEA/Eclipse读取项目路径时若编码设为GBK，会把
项目名/配置文件.txt误识别为乱码路径 -
javac编译含中文包名的源文件时，可能生成错误的class文件名 - Spring Boot加载
application.yml中带中文值的配置项，可能被截断或解析为空
安装JDK时就选英文短路径
这是成本最低、效果最稳的方案。别依赖“以后再改”，很多问题在安装那一刻就埋下了。
立即学习“Java免费学习笔记（深入）”；
- 安装JDK时点“自定义安装”，路径填类似
C:jdk21或D:javajdk-21.0.3，确保全程无中文、无空格、无括号 - 避免
C:Program FilesJava...这种默认路径——它既有空格又有英文括号，cmd解析会出岔子 - 如果已装在中文路径下，不要硬改环境变量指向原路径，重装更可靠（卸载后删干净旧目录）
JAVA_HOME和Path必须用纯英文路径
即使你用软链接或注册表绕过了安装路径限制，JAVA_HOME和Path里也绝不能出现中文字符。系统级环境变量被cmd、PowerShell、Maven、Gradle直接读取，它们不支持UTF-8解码。
-
JAVA_HOME值必须是完整英文路径，例如：C:jdk21，不能带in后缀，也不能加引号 -
Path中添加%JAVA_HOME%in即可，不要写死C:Program Files (x86)Java... - 如果实在无法重装，可用
dir /x查短路径（如C:PROGRA~1JavaJDK21~1.0），但短名不稳定，仅作临时过渡
代码里读取路径时别硬编码中文
就算环境全配对了，运行时拼接中文路径仍是高危操作。比如new File("D:\我的项目\config.txt")在某些JVM参数下仍可能失败。
- 优先用
getClass().getResource("/config.properties")代替File构造器 - 涉及文件I/O时，显式指定编码：
Files.readString(path, StandardCharsets.UTF_8) - 路径拼接用
Paths.get()而非字符串+，它会自动标准化分隔符和编码处理 - Spring Boot项目中，统一在
application.properties里加spring.file.encoding=UTF-8（注意：这只是应用层生效，不替代JVM级-Dfile.encoding=UTF-8）
真正麻烦的不是配环境变量，而是不同环节对路径的编码预期不一致——JVM、IDE、构建工具、操作系统各算各的账。只要路径一含中文，这些账就容易对不上。所以与其花时间调参，不如从安装第一步就掐断源头。
