VSCode本身不带Node.js，必须先安装系统级Node.js并确保node命令在终端中可执行；若node -v报错，根本原因是PATH未正确配置，需重装时勾选“Add to PATH”、避免中文路径、彻底重启VSCode，并通过系统终端验证node -v和npm -v。
VSCode 本身不带 Node.js，必须先装好系统级 Node.js 并确保 node 命令在终端里能直接执行；否则所有后续操作（运行、调试、npm install）都会失败。
node -v 报 “not recognized” 怎么办
这不是 VSCode 的问题，而是系统没把 Node.js 加进 PATH。常见原因和应对方式：
- Windows 安装时漏选了 “Add to PATH”——重装 Node.js LTS 版，务必勾选此项
- 安装路径含中文或空格（如
C:\我的软件\nodejs）——卸载后重装到纯英文路径（如C:\nodejs） - VSCode 启动早于环境变量更新——彻底退出 VSCode（任务管理器确认
Code.exe进程已结束），再重新打开 - macOS/Linux 用
nvm但没激活版本——在终端执行nvm use --lts，再验证which node
验证方式：关掉所有终端，新开一个系统终端（CMD/PowerShell/Terminal），运行 node -v 和 npm -v。只有这一步成功，VSCode 才可能正常工作。
VSCode 内置终端能跑 node，但调试按钮（▶️）报错
调试器启动失败，90% 是 launch.json 配置不对，或项目没以文件夹形式打开：
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 必须通过「文件 → 打开文件夹」打开整个项目目录（含
app.js或index.js），不能只打开单个 JS 文件 - 按
Ctrl+Shift+P输入Debug: Open Configuration，选Node.js → Current File，生成的launch.json中"program"应为"${file}"（不是写死"./index.js"） - 如果手动改过
launch.json，确认"type": "node"和"request": "launch"没被删或拼错 - 调试前务必先保存文件（
Ctrl+S），VSCode 不会自动保存未改动的文件再运行
npm install 后 require('express') 报错 Cannot find module
不是 Express 没装上，而是当前终端工作目录不对，或 node_modules 不在正确位置：
- 确保在 VSCode 内置终端中，路径是项目根目录（即有
package.json的那一层），而不是某个子文件夹 - 运行
npm init -y创建package.json后，再执行npm install express - 检查是否误用了全局安装（
npm install -g express）——Express 必须本地安装，全局装了也无效 - 如果用的是
import语法但没配type: "module"，会触发require is not defined错误——要么改用const express = require('express')，要么在package.json里加"type": "module"
Code Runner 插件右键“Run Code”失败
这个插件默认不走 node 环境，而是调用独立沙箱，对 require、模块路径、process.argv 等支持极差：
- 初期别依赖它——坚持在终端手敲
node app.js，路径、错误、权限一目了然 - 如果非要启用，需在 VSCode 设置里搜索
Code-runner: Executor Map，找到javascript对应项，改成"node $fullFileName" - 它无法触发断点、不读
launch.json、不加载node_modules路径——调试请始终用 F5，运行验证请始终用终端
最容易被忽略的一点：VSCode 终端是否真正继承了你 shell 的全部环境（比如 npm 镜像、自定义 prefix）。哪怕 npm -v 成功，nodemon 仍可能找不到，就因为全局 bin 目录没进 PATH——这时不是重装，而是检查 npm config get prefix 输出的路径有没有加进系统环境变量，并重启 VSCode。
