jdk 安装路径包含中文字符会导致 java 程序在启动或编译时因无法正确解析文件路径而报错,处理方法是把 jdk 重新安装到全英文、无空格的路径下。具体做法是将当前 jdk 目录整体移动到一个纯 ascii 字符的目录下,然后更新系统环境变量 java_home 和 path 指向新位置,重启终端后验证即可。

如何修改环境变量以适配新路径
修改环境变量的核心是确保 JAVA_HOME 指向新的 JDK 根目录,并将该目录下的 bin 子目录加入 PATH。在 Windows 系统中,这通常通过“系统属性”中的“环境变量”界面完成;在 macOS 或 Linux 中,则需编辑 shell 配置文件如 .bashrc 或 .zshrc。操作完成后必须重启命令行窗口或 IDE,使配置生效。

export JAVA_HOME=/usr/local/lib/jdk-17 export PATH=$JAVA_HOME/bin:$PATH
上述代码展示了在 Unix-like 系统中设置环境变量的标准写法。执行后,可以通过运行 java -version 来确认是否成功指向了新路径且不再报错。如果路径中仍残留中文或特殊符号,Java 进程依然可能抛出 Error: Could not create the Java Virtual Machine 或类似的文件系统异常。
IDE 中如何同步更新 JDK 路径
集成开发环境(IDE)如 IntelliJ IDEA 或 Eclipse 通常拥有独立于系统的环境变量缓存,因此仅修改系统变量后,IDE 可能仍然读取旧的中文路径导致构建失败。需要在 IDE 的设置中手动指定新的 JDK 位置,并清理项目缓存。对于 IntelliJ IDEA,可以在 File > Project Structure > SDKs 中添加新路径并移除旧路径;对于 Maven 项目,还需检查 settings.xml 中是否硬编码了旧路径。

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
<localRepository>/path/to/repo</localRepository>
<profiles>
<profile>
<id>jdk-profile</id>
<properties>
<maven.compiler.source>17</maven.compiler.source>
<maven.compiler.target>17</maven.compiler.target>
</properties>
</profile>
</profiles>
</settings>
Maven 配置文件本身不直接定义 JAVA_HOME,但它依赖系统环境或 toolchains.xml 来定位编译器。如果项目中使用了 toolchains.xml,必须确保其中的 jdkHome 字段也更新为无中文的新路径,否则 Maven 构建时会再次因路径解析错误而中断。
验证新路径下 Java 命令行的实际输出
在完成路径迁移和环境变量更新后,最直接验证成功与否的方式是在终端中执行版本查询命令。如果配置正确,终端应返回具体的 Java 版本号、供应商信息以及运行时环境细节,而不出现任何关于路径或编码的错误提示。这一步骤能确认底层 JVM 能够正常加载类库和启动虚拟机。
java -version javac -version
预期输出应类似于:
java version "17.0.1" 2021-10-19<br> Java(TM) SE Runtime Environment (build 17.0.1+12)<br> Java HotSpot(TM) 64-Bit Server VM (build 17.0.1+12, mixed mode, sharing)
同时
javac -version 也应返回匹配的编译器版本。若此时仍报错,请检查是否有其他进程锁定了旧路径文件或注册表项未刷新。

















