VSCode和Node.js必须分别独立安装并配置，VSCode不自带Node.js运行时；需在系统终端验证node -v和npm -v成功，确保PATH生效，并使VSCode终端继承shell环境，launch.json中program推荐设为"${file}"。

VSCode 和 Node.js 是两个独立软件，必须分别安装、各自配置，不能互相替代或自动联动。很多人卡在“装完 VSCode 就能跑 Node”，结果 node -v 在 VSCode 终端里报错，本质是 Node.js 根本没装好，或环境变量没生效。

Node.js 必须独立安装并验证可用性

VSCode 不自带 Node.js 运行时，它只是个编辑器。你得先从 nodejs.org 下载安装包，而不是靠 VSCode 插件“补上”。

• Windows 用户：安装时务必勾选 Add Node.js to PATH；否则手动把 C:\Program Files\nodejs（或你自定义的安装路径）加进系统 Path 变量
• macOS/Linux 用户：若用 homebrew 安装，确认 which node 输出路径已写入 ~/.zshrc 或 ~/.bash_profile
• 验证方式只有一种：关掉所有终端和 VSCode，新开一个系统终端（不是 VSCode 里的 Terminal），执行 node -v 和 npm -v 都能输出版本号才算成功

VSCode 终端是否继承 shell 环境，决定 npm 能不能用

即使你在系统终端里能用 nodemon，但在 VSCode 里提示 command not found，大概率是 VSCode 的终端没读取你的 shell 配置文件（比如 ~/.zshrc）。

Rydberg Agent Node

使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r

下载

• 重启 VSCode 是最直接的办法——它会在启动时重新加载 shell 环境
• 临时补救：在 VSCode 终端里手动执行 source ~/.zshrc（macOS/Linux）或 refreshenv（PowerShell）
• 别依赖“VSCode 自动识别 npm 镜像或全局路径”，npm config get prefix 和 npm config get registry 的输出，必须和你在系统终端里看到的一致

launch.json 中的 program 字段别写死路径

VSCode 调试时生成的默认 launch.json 通常是 "program": "${workspaceFolder}/app.js"，但你项目入口可能是 index.js、server.js 或其他名字。

• 推荐写成 "program": "${file}"：调试当前打开的 JS 文件，不用反复改配置
• 如果固定用某个入口，明确写成 "program": "${workspaceFolder}/index.js"，别用相对路径如 ./index.js，VSCode 解析可能出错
• 注意：launch.json 不会自动保存未保存的文件，调试前必须先按 Ctrl+S（Windows/Linux）或 Cmd+S（macOS）

最容易被忽略的其实是环境变量的“生效层级”：Node.js 安装时的 PATH、shell 配置里的 npm 设置、VSCode 启动时读取的环境三者必须对齐。断在哪一层，问题就卡在哪一层，不能笼统说“环境没配好”。