jdk安装路径含中文必须彻底迁移到纯英文路径，因jvm底层系统api调用时非ascii路径编码不一致，会导致javac报错、maven失败、ide抛noclassdeffounderror；需卸载/删除旧jdk，重装至如d:\dev\jdk-17.0.2，更新java_home、path、classpath，并验证java/javac版本及路径无中文。
JDK安装路径含中文必须彻底修改，不能靠临时转义或加引号解决。根本原因是JVM底层调用系统API时对非ASCII路径编码不一致，会导致javac报错、Maven构建失败、IDE运行抛NoClassDefFoundError等连锁问题。
确认当前中文路径问题
打开命令行，执行：
echo %JAVA_HOME%若输出含“桌面”“文档”“下载”或任何中文字符，说明已中招。同时检查Path中是否包含%JAVA_HOME%\bin——只要其中任意一环含中文，整个Java工具链就不可靠。
安全迁移JDK到纯英文路径
不建议在原路径上重命名或剪切粘贴，应重新安装或解压：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 卸载现有JDK（控制面板 → 卸载程序），或直接删除整个含中文的JDK文件夹（如
C:\用户\张三\Downloads\jdk-17） - 新建纯英文无空格路径，例如：
D:\dev\jdk-17.0.2或C:\jdk17 - 重新下载JDK安装包（exe或zip），安装/解压到该新路径
- 确保该路径下能直接看到
bin、lib、jre等标准子目录
重配环境变量三步到位
路径换新后，必须同步更新三处关键配置：
-
JAVA_HOME：变量值设为新路径的根目录（不含
\bin），例如D:\dev\jdk-17.0.2 -
Path：编辑系统Path，删除旧的
%JAVA_HOME%\bin引用，新增一行%JAVA_HOME%\bin -
CLASSPATH（可选但推荐）：若存在，更新为
.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar;
验证是否真正生效
关闭所有已打开的命令行窗口，新开一个cmd或PowerShell：
java -versionjavac -version
where java
where javac
前三条应显示版本号；最后两条应返回路径，且路径中不含中文、空格，且与%JAVA_HOME%\bin完全一致。若任一环节失败，说明某处仍残留旧路径。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
