node.js未进系统path，需先在系统终端执行node -v验证；windows重装时勾选add to path，macos/linux将which node路径写入~/.zshrc并重启vscode。
node -v 在系统终端报 command not found 怎么办
这说明 Node.js 根本没进系统 PATH，VSCode 后续所有操作都会失败。别急着开 VSCode，先在系统原生命令行（Windows 的 CMD/PowerShell、macOS/Linux 的 Terminal）里执行：node -v 和 npm -v。
如果报错，常见原因有：
- Windows 安装时没勾选 Add Node.js to PATH；重装 Node.js 并务必勾选此项
- macOS/Linux 用
brew install node装的，但which node输出路径（如/opt/homebrew/bin/node）没写进~/.zshrc或~/.bash_profile - 安装路径含空格或中文（如
C:Program Files odejs或D:软件 odejs），会导致 PATH 解析失败；建议重装到纯英文无空格路径（如C: odejs）
VSCode 终端里 node -v 正常，但 npm install 报错或卡住
说明环境变量继承了，但 npm 配置可能不生效。重点检查两件事：
-
npm config get registry是否返回国内镜像地址（如https://registry.npmmirror.com），不是https://registry.npmjs.org -
npm config get prefix返回的全局路径是否已加入系统 PATH（尤其是 Windows 用户改了prefix却忘了同步加进环境变量） - 改完配置后，必须关掉所有 VSCode 窗口再重启——内置终端不会自动 reload shell 配置
launch.json 调试时提示 “Cannot find runtime 'node'”
VSCode 调试器找不到 node 可执行文件，不是因为没装 Node.js，而是它没按你预期的路径去找。根本原因是：runtimeExecutable 字段为空时，VSCode 会用自己的逻辑查 PATH，和你在终端里看到的 which node 结果可能不一致。
解决办法：在 .vscode/launch.json 的配置里显式指定：
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
{
"type": "node",
"request": "launch",
"runtimeExecutable": "/usr/local/bin/node",
"program": "${file}"
}
Windows 用户填绝对路径，如 "runtimeExecutable": "C:\nodejs\node.exe"；macOS/Linux 用户用 which node 输出的真实路径。验证方式：在代码里加一行 console.log(process.execPath)，对比输出是否和 runtimeExecutable 一致。
Code Runner 插件运行 JS 文件报 Cannot use import statement outside a module
这不是环境问题，是执行方式不匹配项目模块类型。Code Runner 默认用 node xxx.js 执行，完全忽略 package.json 里的 "type": "module" 或 "exports" 声明。
正确做法：
- 禁用 Code Runner，直接用 VSCode 内置终端执行：
node index.js - 如果项目是 ESM，确保入口文件扩展名是
.mjs，或package.json中有"type": "module" - 调试时用 launch.json，而不是 Code Runner 的 Ctrl+Alt+N 快捷键
最易被忽略的一点：VSCode 终端是否真正加载了你的 shell 配置。哪怕 npm config get registry 在系统终端里是对的，在 VSCode 终端里返回空或旧值，就说明它没读 ~/.zshrc —— 此时手动执行 source ~/.zshrc 或彻底重启 VSCode 才能解决。
