唯一可靠解法是重装到纯英文无空格路径，因中文路径会导致java、javac、mvn、IDE及Docker在各环节稳定报错，错误信息隐蔽、排查成本高。

直接重装到纯英文、无空格路径，这是唯一可靠解法。中文路径不是“可能出问题”，而是会让 java、javac、mvn、IDE 甚至 Docker 构建在不同环节稳定报错，且错误信息往往不指向路径本身，排查成本极高。

为什么中文路径必须避免

JVM 和多数 Java 工具链底层依赖标准文件路径解析和 URL 编码机制。中文字符在 Windows 的 CreateProcessW 或跨平台脚本中易被错误转义或截断，典型表现包括：

• URISyntaxException：JVM 尝试把含中文的路径转成 file:/// URL 时解码失败
• NoClassDefFoundError：Maven 或 IDE 加载 rt.jar 时路径被截断，找不到核心类
• error: invalid flag: 项目：javac 把路径里的“项目”二字误认为编译参数
• Docker 构建静默退出，无日志，返回错误码 1

正确重装操作步骤

不要尝试修改注册表、改环境变量或加引号绕过——这些只是临时掩盖，无法根治。

• 卸载当前 JDK（控制面板或安装目录里的 uninstall.exe）
• 下载最新 JDK 21 安装包，右键选择“以管理员身份运行”
• 安装时点“自定义”，路径手动输入：D:\jdk21 或 C:\dev\jdk21（仅限英文字母、数字、下划线、短横线，无空格、无中文、无特殊符号）
• 安装完成后，进入该目录，确认存在 bin、lib、jre 三个文件夹

JAVA_HOME 与 Path 必须同步更新

旧路径残留是常见失败原因，务必按顺序执行：

javascript-typescript-typescript-scaffold

你是 TypeScript 项目架构专家，专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链（pnpm、Vite、Next.js）、类型

下载

• 打开“系统属性 → 高级 → 环境变量”
• 在“系统变量”中新建：
  变量名：JAVA_HOME
  变量值：D:\jdk21（结尾不加反斜杠，也不带 \bin）
• 编辑 Path 变量，在最顶部新增一行：%JAVA_HOME%\bin
• 关闭所有已打开的命令行窗口，重启电脑（强制刷新系统级变量缓存）

验证是否真正生效

重启后打开全新 CMD 窗口，逐行执行：

• echo %JAVA_HOME% → 应输出 D:\jdk21
• where java → 应只返回一行，路径为 D:\jdk21\bin\java.exe
• java -version 和 javac -version → 两行均显示 21.x.x，版本一致

若任一检查失败，说明仍有旧路径残留或某处配置未生效，需重新核对三处：安装路径、JAVA_HOME 值、Path 中的 %JAVA_HOME%\bin。