根本原因是Windows编码链断裂与PowerShell路径解析缺陷，需三层面协同解决：关闭系统UTF-8 Beta选项并重启，VSCode终端改用Command Prompt或Git Bash，npm脚本路径统一用正斜杠且加引号，全局npm路径须为纯英文。
VSCode 中执行 npm 脚本时因路径含中文报错，根本不是 npm 或 Node.js 本身不支持中文，而是 Windows 下编码链断裂 + PowerShell 路径解析缺陷 + npm 子进程继承错误代码页共同导致的连锁反应。直接改 launch.json 或终端字体没用，必须从系统层、终端层、脚本调用层三处协同处理。
Windows 系统区域设置必须关掉 UTF-8 Beta 选项
这是所有问题的起点。只要勾选了「Beta版:使用Unicode UTF-8提供全球语言支持」，Node.js 的 child_process.spawn 就会把 VSCode 传入的 UTF-8 路径二次编码成乱码，npm 启动时拿到的就是一串无法识别的字节流，典型报错：spawn git ENOENT、Command failed: git status、Unable to resolve non-existing file。
- 打开「控制面板 → 区域 → 管理 → 更改系统区域设置」，取消勾选该选项
- 必须重启电脑（仅改设置不重启无效）
- 验证：在 CMD 中运行
chcp，输出应为936，不是65001
VSCode 终端默认 shell 改为 Command Prompt 或 Git Bash
PowerShell 在路径含中文或特殊字符（如 &、%、空格）时，对引号包裹路径的解析极不稳定，常把 cd "D:我的项目" 拆成多个参数，或触发字符串展开导致截断。npm 脚本里若调用了 sh、git 等外部命令，更容易崩。
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 在 VSCode 设置中搜索
terminal.integrated.defaultProfile.windows，改为Command Prompt或已安装的Git Bash - 避免在路径中使用
&、、<code>>、|、%——这些是 shell 元字符，加引号也救不了 - 若坚持用 PowerShell，请在终端中运行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser，再重启终端
npm script 中路径变量必须显式加引号且用正斜杠
npm 本身不处理路径转义，全靠宿主 shell 解析。CMD 和 PowerShell 对反斜杠 的转义规则不同，而中文路径 + 反斜杠极易被 CommandLineToArgvW 误判为非法转义序列，直接截断。
- 在
package.json的scripts字段中，路径一律用正斜杠："build": "tsc --outDir ./dist"，而非"build": "tsc --outDir .\dist" - 若需拼接动态路径（如调用本地 bin），务必用双引号包裹整个参数：
"dev": "node "./scripts/start.js"" - 禁止在 script 字符串里写未转义的中文括号、全角空格、顿号——它们比汉字更易触发分词失败
npm 全局安装路径不能含中文
即使你本地项目路径没问题，npm 全局 bin 目录（如 C:Users张三AppDataRoaming
pm）含中文也会导致 npm install -g 安装的 CLI 工具（如 vercel、typescript）启动失败，报 spawn xxx ENOENT。
- 检查当前全局路径：
npm config get prefix - 若路径含中文，重设为纯英文路径：
npm config set prefix C: ools pm-global - 把新路径加进系统
PATH环境变量（需重启 VSCode 终端生效） - 确认
where npm输出的路径与npm config get prefix一致
最常被忽略的是：npm 脚本里调用的子命令（比如 git、python、gcc）各自有独立的编码逻辑，哪怕 VSCode 和终端都配对了，只要其中任意一个环节仍用 CP936 去 decode UTF-8 路径，就会静默失败——没有报错，只是路径被截断或返回空结果。
