中文路径是导致javac不识别、ide找不到jdk、脚本执行失败的高频原因；必须避开含中文、空格、特殊字符及深层嵌套路径，推荐使用d:\dev\jdk-21等无中文无空格浅层级路径，并手动安装时指定。

Windows 10 安装 JDK 21 时，路径含中文是导致 javac 不识别、IDE 找不到 JDK、脚本执行失败 的高频原因。这不是小问题，而是从安装那一刻就埋下的隐患——系统和多数开发工具（如 Maven、Gradle、IntelliJ）默认不兼容中文路径，解析时容易乱码或截断。

为什么中文路径会出问题

Java 工具链底层大量依赖标准 POSIX 路径规范，而 Windows 中文路径在 CMD/PowerShell 中常被转义为短文件名（如 C:\Users\ADMINI~1），部分构建工具无法正确映射；更常见的是，Ant、Maven 的 XML 配置或 Gradle 的 groovy 脚本在读取含中文的 JAVA_HOME 时直接抛出 InvalidPathException 或静默失败。

安装时必须避开的路径类型

• 含中文的路径：如 C:\软件\jdk21、D:\开发工具\JDK-21 —— 全部禁止
• 含空格的路径：如默认的 C:\Program Files\Java\jdk-21 —— 空格会被 Shell 当作参数分隔符，导致 java -version 正常但 mvn compile 报错
• 含特殊字符的路径：如 C:\My-JDK#21!、D:\JDK@21 —— 某些 shell 或旧版 IDE 会误解析符号
• 系统盘根目录或深层嵌套路径：如 C:\jdk21（权限受限）、D:\a\b\c\d\jdk-21（路径过长易触发 Windows MAX_PATH 限制）

推荐的安全路径写法

选一个**非系统盘、无中文、无空格、层级浅、易记忆**的位置：

Writecream

一款集AI写作、营销文案和内容创作于一体的在线工具，可辅助生成文章、广告、邮件等多种类型的文本内容。

下载

• D:\Dev\jdk-21（简洁常用，适合多数人）
• C:\jdk21（若坚持用 C 盘，确保以管理员身份运行安装程序）
• E:\JDK\21（清晰分层，便于多版本共存）

安装过程中，务必点击「更改」按钮手动输入上述任一路径，不要直接点「下一步」用默认路径。

验证路径是否真正生效

安装完成后，别急着配环境变量——先确认安装目录本身是否干净：

• 打开文件资源管理器，直接粘贴你填的路径（如 D:\Dev\jdk-21）回车，能正常进入且看到 bin、lib 等文件夹
• 在该 bin 目录下按住 Shift + 右键 →「在此处打开 PowerShell 窗口」，运行：
  .\java.exe -version 和 .\javac.exe -version，均应输出版本号
• 如果报错“找不到指定的文件”，说明路径写错、安装损坏，或防病毒软件拦截了 exe 执行