vscode能运行node.js的前提是系统终端中node -v和npm -v均能输出版本号；否则所有后续操作均失败。需确保安装时勾选add to path（windows）、路径无空格/中文，macos/linux下nvm配置已加载，改环境变量后必须彻底重启vscode，并在launch.json中显式设置runtimeexecutable以匹配实际node路径。
VSCode 能直接跑 Node.js，但前提是 node 命令在终端里能被识别——否则所有后续操作（运行、调试、插件调用）都会失败，不是 VSCode 的问题，是环境没配对。
验证 node 和 npm 是否真可用
很多人卡在这一步却反复重装 VSCode 或插件。必须在系统终端（不是 VSCode 内置终端）里执行：
-
node -v和npm -v都得输出版本号 - Windows 用户安装时没勾选 Add to PATH，或路径含空格/中文（如
C:Program Files odejs），npm可能静默失败 - macOS/Linux 用
nvm的，要确认source ~/.nvm/nvm.sh已写入~/.zshrc或~/.bash_profile，且新开终端已加载 - 改完环境变量后，必须完全关闭并重启 VSCode，否则内置终端仍读不到新 PATH
别依赖 Code Runner 运行 ES Module 项目
Code Runner 插件默认用 node 执行 JS 文件，但它不读 package.json 里的 "type": "module" 或 exports 字段，容易报错 Cannot use import statement outside a module。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 正式开发中，直接用 VSCode 内置终端（
Ctrl+`）执行node index.js，行为与部署环境一致 - 若项目声明了
"type": "module"，确保文件扩展名是.mjs，或入口文件明确加.js后缀且package.json中有对应配置 -
Code Runner的Ctrl+Alt+N仅适合单文件快速验证，不适合模块化项目
launch.json 必须显式指定 runtimeExecutable
VSCode 调试器默认按 PATH 找 node，但如果你用 nvm、fnm 或多个 Node 版本共存，它很可能调用错版本，导致断点不触发、require 行为异常、源码映射失败。
- 在项目根目录建
.vscode/launch.json，写死runtimeExecutable路径：
macOS/Linux 示例："runtimeExecutable": "/usr/local/bin/node"
Windows 示例："runtimeExecutable": "C:\nodejs\node.exe" - 加一行
console.log(process.execPath)对比输出，确认调试器用的确实是这个路径 - 不要用自动生成的
"program": "${workspaceFolder}/app.js"，改成"program": "${file}"，避免换文件调试时 F5 直接报错
npm 全局路径和镜像建议提前设好
国内直连官方 registry 经常卡在 npm install，且全局模块（如 nodemon）默认装 C 盘，容易占满空间。
- 换淘宝镜像：
npm config set registry https://registry.npmmirror.com - 改全局路径（例如 D 盘）：
npm config set prefix "D:\npm-global"，再把该路径加进系统PATH - 改完后重装工具：
npm install -g nodemon，否则旧版本还在原路径 - VSCode 终端是否继承 shell 配置？如果系统终端能用
nodemon，VSCode 里却提示command not found，大概率是终端没加载~/.zshrc，重启 VSCode 或手动执行source ~/.zshrc更直接
真正容易被忽略的，是 npm -v 成功这件事——VSCode 调试器底层靠它启动脚本，不是可选项；还有 process.execPath 输出和 runtimeExecutable 是否一致，这一步不验证，断点永远停不住。
