能跑 node -v 且 VSCode 能断点调试才算真正搭好；必须在系统终端执行 node -v 和 npm -v 均输出版本号，再配置正确 launch.json（program 字段指向真实入口文件），断点才生效。

能跑 node -v 且 VSCode 能断点调试，才算真正搭好；其余全是锦上添花。

验证系统级 Node.js 是否真可用

很多人卡在“VSCode 报错找不到 node”，其实问题根本不在 VSCode —— 是系统 PATH 没配对。必须在系统终端（不是 VSCode 内置终端）里执行：

• node -v
• npm -v

两者都输出版本号才算过关。如果报 'node' 不是内部或外部命令：

• Windows：重装 Node.js LTS 版，安装时务必勾选 “Add to PATH”；若已装过，手动把 C:\Program Files\nodejs（或你实际的安装路径）加进系统环境变量 Path，然后关掉所有终端窗口再重开
• macOS/Linux：用 nvm 的话，确认 source ~/.nvm/nvm.sh 已写入 ~/.zshrc 或 ~/.bash_profile，且新终端已加载
• 路径含中文或空格（如 D:\我的软件\nodejs）会导致 npm 静默失败，必须避开

VSCode 调试器不用装插件，但 launch.json 得设对

VSCode 自带 Node.js 调试支持，Node.js Extension Pack 这类插件现在已过时，装了反而可能冲突。只需三步：

Rydberg Agent Node

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

下载

• 新建项目文件夹，创建 index.js，写 console.log('ok');
• 按 Ctrl+Shift+P（macOS 是 Cmd+Shift+P），输入 Debug: Open Configuration，选 Node.js → Current File
• VSCode 自动生成 .vscode/launch.json，关键字段是 "program": "${file}" —— 表示运行当前打开的 JS 文件

常见错误：

• 断点不生效、F5 启动报 Cannot find runtime 'node'：一定是 node -v 在系统终端都失败，不是配置问题
• 调试时提示 “无法启动程序”：检查 launch.json 中 "program" 是否指向了真实存在的入口文件（比如你主文件叫 app.js，就得改成 "${workspaceFolder}/app.js"）
• 没保存就点 F5：VSCode 不会自动保存，调试前务必按 Ctrl+S

全局 npm 工具（如 nodemon）在 VSCode 终端里用不了？PATH 没继承

你在 CMD 或 Terminal 里能用 nodemon，但在 VSCode 终端里提示 command not found，大概率是 VSCode 没读到你 shell 的环境变量。

• 如果你改过 npm 全局路径（例如执行过 npm config set prefix "D:\npm-global"），必须把该路径加进系统 Path 变量
• 改完后关闭并重开整个 VSCode（不只是重启终端），否则它不会重新读取 PATH
• macOS/Linux 用户可在 VSCode 终端里手动执行 source ~/.zshrc 快速加载配置，但更稳妥的是确保 shell 配置已自动加载

国内开发建议提前配好镜像和路径：

• npm config set registry https://registry.npmmirror.com
• npm config set prefix "D:\npm-global"（Windows）或 ~/npm-global（macOS/Linux）
• 配完验证：npm config get registry 和 npm config get prefix

最常被忽略的一点：VSCode 内置终端是否真正继承了你 shell 里生效的全部环境变量。不要假设“系统终端能用，VSCode 就一定行”——它不自动同步 PATH 变更，也不自动 source 你的 shell 配置文件。