VSCode本身不配置Node环境，只调用系统已安装的node/npm；终端找不到命令是因未继承shell PATH，调试报错是launch.json配置问题，缓存污染会导致npm install失败，需清理缓存、换源、用rimraf安全删除node_modules。
VSCode 本身不“配 Node 环境”，它只是调用你系统里已装好的 node 和 npm；真正卡住你的，往往是终端能跑、调试器报错、缓存污染导致 install 失败这三类问题。下面直奔实操。
VSCode 终端找不到 node 或 npm 怎么办
这不是 VSCode 设置错了，是它没继承你 shell 的 PATH。
- macOS/Linux：确认
~/.zshrc或~/.bash_profile里有export PATH=...:$PATH，然后在 VSCode 里按Cmd+Shift+P→ 输入Developer: Reload Window；还不行就直接从终端执行code .启动 - Windows：安装 Node.js 时没勾选
Add to PATH是最常见原因；手动把C:Program Files odejs（或你实际的安装路径）加到系统环境变量PATH里；或者在 VSCode 设置中加这条：
"terminal.integrated.env.windows": {
"PATH": "%PATH%;C:\Program Files\nodejs"
}
改完重启 VSCode。
调试时提示 Cannot find runtime 'node'
这是调试器层面的问题，和终端能否运行 node 无关。关键看 .vscode/launch.json 里的配置是否合理。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 删掉
"runtimeExecutable"字段——让它走默认查找逻辑，比硬写路径更稳 - 如果项目必须用特定 Node 版本（比如
v18.17.0），且你用了nvm，那就显式指定："runtimeExecutable": "~/.nvm/versions/node/v18.17.0/bin/node"（macOS/Linux）或"runtimeExecutable": "C:\Users\xxx\AppData\Roaming\nvm\v18.17.0\node.exe"（Windows + nvm-windows） -
"type"必须是小写"node"，不是"Node"或"NODE"
一键清理 npm 缓存并换国内源
缓存损坏会导致 npm install 卡住、报 ERR! code EINTEGRITY 或下载包校验失败。清缓存不是“可选项”，是每次重装依赖前该做的动作。
- 先验证缓存状态：
npm cache verify—— 如果输出一堆verify failed，说明缓存已坏 - 强制清空：
npm cache clean --force - 换国内源（推荐 npmmirror）：
npm config set registry https://registry.npmmirror.com/ - 顺手设好全局安装路径和缓存目录（避免权限问题）：
npm config set prefix "D:\nodejs\node_global"npm config set cache "D:\nodejs\node_cache"
注意：npm cache clean 在 npm v5+ 后必须加 --force，否则没反应；而 npm config set 修改的是用户级配置，不需要管理员权限。
删 node_modules 别用手动删文件夹
手动删容易删不干净，尤其 Windows 下某些文件被占用会失败。用命令行工具更可靠。
- 全局安装
rimraf：npm install -g rimraf - 进项目根目录后执行：
rimraf node_modules - 如果 PowerShell 报错
无法加载脚本，说明执行策略限制了本地脚本运行，临时放开：Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
真正麻烦的不是删，而是删完重装还失败——那大概率是缓存或源没清理干净，或者 package-lock.json 和 node_modules 状态不一致。这时候别硬刚，先 npm cache clean --force，再删，再 npm install。
