vscode终端无法调用node命令的根本原因是环境变量未正确加载，而非配置错误；需验证which node或where node是否返回路径，并确保~/.zshrc（macos/linux）或系统path（windows）已正确配置且vscode彻底重启后生效。
VSCode 无法调用 node 命令，90% 是环境变量没通到它的终端里，不是配置写错了。
为什么 VSCode 终端里 node -v 报 command not found
VSCode 内置终端启动时，会读取当前 shell 的环境变量（比如 macOS 的 ~/.zshrc、Windows 的系统 Path），但不会自动继承你手动改完后未刷新的配置。很多人在系统终端里能跑 node -v，一进 VSCode 就失效，就是因为这个断层。
- Windows 用户：安装 Node.js 时没勾选 Add Node.js to PATH，导致
where node在 VSCode 终端里返回空 - macOS 用户：Homebrew 安装后，
which node在 iTerm 里有结果，但在 VSCode 里报错——大概率是~/.zshrc没被 VSCode 终端加载 - Linux 用户：PATH 被写在
~/.bash_profile，但 VSCode 启动的是非登录 shell，只读~/.bashrc
验证 VSCode 是否真能访问 Node.js
别信“我装过了”，必须在 VSCode 自己的终端里验证。关掉所有 VSCode 窗口（macOS Dock 右键「退出」，Windows 任务管理器确认 Code.exe 已结束），再重新打开项目文件夹。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 按
Ctrl+`打开内置终端 - 立刻执行
which node（macOS/Linux）或where node（Windows），看是否返回类似/usr/local/bin/node或C:\Program Files\nodejs\node.exe - 紧接着跑
npm -v，失败说明 npm 没随 node 一起注入 PATH - 如果任一命令失败，就不是 launch.json 的问题，是环境根本没接上
launch.json 中 program 字段怎么写才不踩坑
VSCode 调试器对路径极其敏感，program 必须指向一个真实存在的 .js 文件，且路径不能靠猜。
- 不要写
"program": "app.js"—— 这是相对路径，调试器默认从项目根目录找，但实际可能不在那里 - 推荐写成
"program": "${workspaceFolder}/index.js"，前提是你的入口文件确实是index.js且在工作区根目录 - 想调试当前打开的文件？用
"program": "${file}"，但注意：VSCode 不会自动保存未保存的修改，调试前务必按Ctrl+S - 如果用了
nodemon，launch.json 里要加"runtimeArgs": ["--inspect-brk"]，否则断点不生效
npm 全局工具（如 nodemon）在 VSCode 里找不到怎么办
即使 node 和 npm 都通了，nodemon 仍可能报 command not found，因为全局 bin 目录没加进 PATH。
- 先查全局安装位置：
npm config get prefix，通常返回类似/Users/xxx/.npm-global或D:\npm-global - 把这个路径加进系统环境变量（Windows 是系统 Path，macOS/Linux 是 shell 配置文件末尾加
export PATH="$HOME/.npm-global/bin:$PATH"） - 改完后重启 VSCode，再在终端里执行
source ~/.zshrc（macOS）或新开终端 - 验证：
which nodemon应该有输出；如果还是没有，重装一次：npm install -g nodemon
最常被忽略的一点：VSCode 终端是否加载了你 shell 配置里的 PATH 修改。哪怕你在终端里手动 export PATH=... 成功了，下次新开终端依然失效——必须把 export 写进 ~/.zshrc 或对应配置文件，并确保 VSCode 启动时读它。
