VSCode本身不提供Node.js运行环境，必须安装系统级Node.js并确保PATH正确配置；终端中node -v成功但VSCode报错，根本原因是VSCode未继承Shell或系统PATH，需通过终端启动code .（macOS/Linux）或重装Node时勾选“Add to PATH”（Windows）解决，并在VSCode内置终端验证。
VSCode 本身不提供 Node.js 运行环境，它只是一个编辑器；真正要装的是 Node.js 运行时，VSCode 只负责调用它。只要 node 命令能在系统终端（CMD/PowerShell）里执行成功，VSCode 就能用 —— 不需要在 VSCode 里“安装 Node”，更不需要搜“Node.js 扩展”来运行 JS。
node -v 报错：'node' 不是内部或外部命令
这是最常见也最核心的问题：VSCode 的终端找不到 node。根本原因不是 VSCode 配置错了，而是 Windows 没把 Node.js 加进系统 PATH 环境变量。
- 先确认你是否真的装了 Node.js：去 nodejs.org/download 下载 LTS 版本的
.msi包，双击安装，**务必勾选 “Add to PATH”**（这步跳过就必然报错） - 安装完必须重启所有已打开的终端（包括 VSCode 内置终端）—— VSCode 不会自动继承新 PATH
- 在全新打开的 CMD 里执行
node -v和npm -v，有输出才说明装对了；如果没输出，别急着配 VSCode，先解决这个 - 如果你用的是
nvm-windows，记得装完后执行nvm use <version>激活版本，否则node依然不可用
VSCode 终端里 node 正常，但调试时提示 “无法启动程序”
这通常是因为 launch.json 里指定的入口文件路径不对，或者工作区没打开项目根目录。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 确保你在 VSCode 里是通过 “文件 → 打开文件夹” 打开整个项目（比如含
package.json或app.js的文件夹），而不是只打开单个 JS 文件 - 按
Ctrl+Shift+D进入调试视图，点 “创建 launch.json”，选 “Node.js” 环境，VSCode 会生成默认配置 - 检查生成的
launch.json中"program"字段：它默认指向"${workspaceFolder}/index.js"，如果你的主文件叫app.js，就得手动改成"${workspaceFolder}/app.js" - 不要动
"type": "node"和"request": "launch"，这两个是调试器识别的关键，改错会导致整个调试流程失效
npm install -g 全局命令在 VSCode 终端里找不到
比如装了 http-server 或 nodemon，CMD 能用，VSCode 终端却说 command not found —— 这基本等于全局 bin 目录没进 PATH。
- 如果你手动改过 npm 全局路径（比如执行过
npm config set prefix），就必须把那个新路径（如D:\software\nodejs\node_global）加进系统环境变量PATH里 - 加完后，**关闭并重开 VSCode**（不是仅重启终端），否则它读不到更新后的 PATH
- 验证方式：在 VSCode 终端里执行
npm config get prefix，再执行echo $env:Path（PowerShell）或echo %PATH%（CMD），看输出里有没有前者路径 - 别依赖 VSCode 的 “自动检测 PATH” 功能，它不可靠；Windows 的 PATH 变更必须显式重启编辑器进程
真正卡住人的从来不是 VSCode 设置，而是 Node.js 是否真正在系统层面可用。所有 VSCode 相关问题，90% 都能退回到 CMD 里用 node、npm、which node（PowerShell 用 Get-Command node）三连问定位清楚。路径、权限、PATH、进程重启 —— 这四个点漏掉任何一个，都会让看似简单的环境搭建变成无头苍蝇。
