JDK安装路径应设为短路径名以避免空格、中文和过长路径引发的兼容性问题;推荐安装时直接选择C:\Java\jdk-17等简短规范路径,或已安装情况下使用8.3短文件名(如C:\PROGRA~1\Java\JDK-17~1)配置JAVA_HOME。

JDK 安装目录设为短路径名,核心目标是避开空格、中文和过长路径带来的兼容性问题。最稳妥的做法不是“后期改名”,而是在安装时就选一个天然简短、规范的路径。
安装时直接选短路径
双击 JDK 安装包后,在“选择安装路径”步骤中,手动输入类似以下任一路径:
- C:\Java\jdk-17(推荐,无空格、无中文、层级浅)
- D:\JDK\17(磁盘空间充足时可选)
- C:\jdk17(极简,但注意别和旧版本混淆)
避免使用默认路径如 C:\Program Files\Java\jdk-17.0.2——它含空格且层级深,很多构建工具(Maven、Gradle)、IDE 启动脚本或老版本 Windows API 会出错。
已装在长路径?用 8.3 短文件名替代
如果 JDK 已装在 C:\Program Files\Java\jdk-17.0.2,又不想重装,可用 Windows 内置的 8.3 兼容短名绕过限制:
立即学习“Java免费学习笔记(深入)”;
- 打开命令提示符(CMD),执行:
dir /x查看当前目录下的短名(如PROGRA~1对应Program Files) - 进入
C:\PROGRA~1\Java,再运行dir /x,找到 JDK 文件夹的短名(常见为JDK-17~1或JDK170~1) - 将 JAVA_HOME 设为:
C:\PROGRA~1\Java\JDK-17~1(末尾不加\bin) - PATH 中仍写
%JAVA_HOME%\bin,系统能正确解析
这个方法无需改注册表、不开长路径支持,所有 Java 工具都认,是最稳定的事后补救方式。
不建议强行重命名或符号链接
手动给 Program Files 改名为 Progra~1 或用 mklink 建软链接,看似省事,实则风险高:
- Windows 可能拒绝重命名系统目录
- 符号链接在某些 IDE 或容器环境中不可见或权限异常
- 升级 JDK 时容易丢失链接,导致环境突然失效
不如一步到位选短路径,或用 8.3 名稳妥过渡。


















