node.js安装路径含中文必须重装到纯英文路径，因windows加载器会截断路径导致调试崩溃；须关闭系统utf-8 beta选项并重启，且launch.json中runtimeexecutable需显式指定或留空。
Node.js 安装路径含中文会直接崩溃
VSCode 调试或运行 Node.js 时，如果 node.exe 自身路径里有中文（比如 D:开发
odejs
ode.exe），调试器根本无法加载 bootloader，报错类似：Error: Cannot find module 'd:///Microsoft VS Code/resources/app/extensions/ms-vscode.js-debug/src/bootloader.bundle.js'。这不是配置能绕过的——Node 进程启动前就被 Windows 加载器截断了。
必须重装 Node.js 到纯英文路径，例如：C: ools
odejs 或 D:dev
odejs。安装后在终端执行 where node 确认路径无中文、无空格、无括号。
- 卸载旧版 Node.js（控制面板 → 卸载程序）
- 手动删除残留目录：
%PROGRAMFILES% odejs、%LOCALAPPDATA% odejs - 下载官方 MSI 安装包，自定义安装路径时**全程使用 ASCII 字符**
- 安装完重启终端，再运行
node -v和npm -v验证
Windows 系统区域设置开启 UTF-8 Beta 是根因
即使 Node.js 和 VSCode 路径都干净，只要系统开启了「Beta 版：使用 Unicode UTF-8 提供全球语言支持」，Node 子进程就会对 argv 中的路径做二次编码，导致 VSCode 收到乱码路径，表现为空白调试页、Unable to resolve non-existing file 或直接卡死。
必须关闭该选项并重启电脑：
- 控制面板 → 区域 → 管理 → 更改系统区域设置
- 取消勾选「Beta 版：使用 Unicode UTF-8 提供全球语言支持」
- 点击确定 → **立即重启电脑**（不重启无效）
- 重启后打开 CMD，运行
chcp，输出应为活动代码页：936，不是65001
launch.json 中 runtimeExecutable 必须显式指定或留空
VSCode 默认靠 PATH 查找 node，但一旦环境变量混乱或存在多个版本，它可能误选到旧版或中文路径下的副本。调试失败时常见错误是 spawn node ENOENT 或静默退出。
在 .vscode/launch.json 的对应 configuration 中，明确处理 runtimeExecutable：
- 推荐留空：
"runtimeExecutable": ""（让 VSCode 严格按当前终端的PATH查找） - 如需固定版本，填绝对路径：
"runtimeExecutable": "C:\tools\nodejs\node.exe"（注意双反斜杠或正斜杠） - 避免写相对路径、带空格路径、或未转义的中文路径
- 检查右下角状态栏的 Node 版本是否与你预期一致
终端里运行 node 命令仍失败？检查 PATH 和工作目录编码
集成终端里执行 node index.js 报 Cannot find module 或闪退，大概率是当前工作目录含中文，且终端继承了错误的代码页。
不要依赖 CMD 自动识别 UTF-8 路径：
- 确保终端启动时默认代码页是 936：在终端里运行
chcp 936（可加到终端 profile 启动命令） - 用
code .从命令行启动 VSCode，而非双击图标——前者能继承当前 shell 的环境变量和编码 - 避免在资源管理器里右键 → “在 VSCode 中打开”，这种路径传递容易触发 GBK 截断
- 临时验证：把项目挪到
C: estdemo下运行，确认是否还出错——是则说明确实是路径问题，不是代码问题
runtimeExecutable，这三步缺一不可。少一步，spawn node ENOENT 就还在那儿等着。
