根本原因是VSCode终端未继承系统PATH，需重装Node.js并勾选“Add toPATH”，重启所有终端和VSCode后验证；全局命令路径须手动加入系统环境变量PATH；nvm-windows需每次执行nvm use；launch.json中调用CLI应使用npx或项目内.bin路径。

node -v 在 CMD 里能跑，VSCode 终端报 command not found

根本不是 VSCode 配置问题，而是它没继承系统 PATH。Windows 下最常见原因：Node.js 安装时漏勾了 Add to PATH。

• 去 nodejs.org/download 下载 LTS .msi 包，重装，务必勾选 “Add to PATH”
• 安装完必须关闭所有已打开的 CMD、PowerShell 和 VSCode 窗口，再全新启动
• 在全新打开的 CMD 中执行 node -v 和 npm -v，有输出才算真正生效
• 验证 VSCode：按 Ctrl + ` 打开内置终端，再跑一遍 node -v —— 没输出就别往下配

全局命令（如 nodemon、http-server）在 VSCode 终端里找不到

这类命令装在 npm 全局目录下，但 VSCode 的终端没读到那个路径，尤其当你改过 npm prefix 时。

Rydberg Agent Node

使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r

下载

• 查当前全局路径：npm config get prefix，典型输出如 C:\Users\XXX\AppData\Roaming\npm
• 把这个路径手动加进 Windows “系统环境变量” 的 PATH（不是用户变量）
• 加完后必须彻底退出 VSCode 再重开，仅重启终端无效
• 如果用 nvm-windows，记得每次启动后执行 nvm use 18.18.2（换成你实际版本），否则全局 bin 不激活

launch.json 里调用本地 CLI 工具失败（比如用 tsc 或 eslint）

VSCode 调试器默认只认 node，要跑其他命令得靠 runtimeExecutable + runtimeArgs，但写法容易错。

• 不要写成 "runtimeExecutable": "tsc" —— 这会找当前目录下的可执行文件，不是全局命令
• 正确写法是："runtimeExecutable": "${workspaceFolder}/node_modules/.bin/tsc"（项目级）或 "runtimeExecutable": "npx" + "runtimeArgs": ["tsc"]（更通用）
• 注意：如果项目没装 typescript，npx tsc 会临时下载，首次略慢；装了就直接用本地版本
• 调试时若提示 Cannot find module 'typescript'，说明 npx 没 fallback 到全局，优先走 node_modules/.bin/ 路径更稳

code-runner 插件执行本地命令乱码或卡死

它默认用裸 node $fileName，不处理编码、模块类型、stdin 流，对中文路径和 ESM 尤其不友好。

• 在 VSCode 设置里搜 code-runner.executorMap，找到 javascript 对应项
• 改成："node -r utf-8 --experimental-specifier-resolution=node $fileName"（Windows 防乱码 + ESM 支持）
• 遇到 process.stdin 就卡住？这是 code-runner 的硬限制，它不提供输入流 —— 换成终端手动跑或 F5 调试
• 如果脚本依赖 package.json 里的 type: "module"，但 executor 没加 --experimental-specifier-resolution=node，就会报 Cannot use import statement

VSCode 启动方式影响极大：从桌面图标启动，它大概率读不到 shell 初始化后的 PATH；从终端执行 code . 才能继承当前环境。这点在 macOS/Linux 上尤为关键，Windows 用户则更容易忽略安装时的勾选项。