VSCode不自带Node.js，需系统已安装并正确配置PATH；Windows安装时必须勾选“Add to PATH”，否则VSCode终端无法识别node命令，应卸载重装并严格勾选该选项，再通过终端执行code .启动以继承环境变量。
VSCode 本身不装 Node.js，它只调用系统已安装的 node 和 npm；你在 VSCode 里看到 'node' 不是内部或外部命令，说明 Windows 没把 Node.js 加进 PATH，不是 VSCode 配错了，而是系统级环境变量根本没生效。
Node.js 安装时必须勾选 “Add to PATH”
这是 Windows 下 90% 报错的根源。去 nodejs.org/download 下载 LTS 版本的 .msi 安装包，双击运行后，在“Custom Setup”步骤里——务必勾选 Add Node.js to PATH。跳过这步，node -v 在 CMD 能跑，但 VSCode 终端大概率找不到。
如果已经装过但没勾选：
- 卸载现有 Node.js（控制面板 → 卸载程序）
- 重装时严格勾选该选项
- 安装完立刻打开全新 CMD，执行
node -v和npm -v，有输出才算成功
VSCode 启动方式决定它能不能读到 PATH
Windows 上 VSCode 若通过开始菜单或桌面快捷方式启动，它继承的是“登录时”的环境变量快照，不会自动加载新 PATH。哪怕你刚装完 Node.js 并重启了电脑，VSCode 仍可能用旧环境。
正确做法是：
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 在已确认
node -v成功的 CMD 或 PowerShell 里，cd 到你的项目目录，执行code . - 这样 VSCode 会继承当前 Shell 的完整环境变量，PATH 自然包含 Node.js 路径
- 之后所有内置终端、调试器、任务都可用
node和npm
全局 npm 工具（如 nodemon）在 VSCode 里找不到怎么办
现象：npm install -g nodemon 在 CMD 成功，但 VSCode 终端里敲 nodemon 报 command not found —— 这说明 npm 全局 bin 目录没进系统 PATH。
常见原因和解法：
- 如果你改过 npm 全局路径（比如执行过
npm config set prefix "D:\npm-global"），必须手动把该路径（如D:\npm-global）加进系统环境变量Path中 - 加完后，关闭所有 VSCode 窗口，再用
code .从终端启动，不能点快捷方式 - 验证：在 VSCode 终端里执行
npm config get prefix，输出应与你加进 PATH 的路径一致
调试时提示 “无法启动程序”，八成是 launch.json 配错了
VSCode 调试 Node.js 依赖 launch.json 里的 "program" 字段指向正确的入口文件。默认生成的是 "${workspaceFolder}/index.js"，但你的主文件可能是 app.js 或 server.js。
关键点：
- 不要直接改
"type": "node"或"request": "launch"，这两个是调试器识别必需字段，改错就彻底失效 - 确保你是在“文件 → 打开文件夹”模式下打开整个项目（含
package.json），不是只打开单个 JS 文件 - 按
Ctrl+Shift+D→ “创建 launch.json” → 选 Node.js → 手动把"program"改成实际入口，例如"${workspaceFolder}/app.js"
最容易被忽略的其实是：VSCode 终端是否真正继承了你 shell 里已生效的环境配置。哪怕 PATH 加对了，如果终端没读 ~/.zshrc（macOS/Linux）或没走 code . 启动（Windows），一切配置都白搭。
