node.js必须独立安装且正确配置path，vscode不提供运行时；node -v报错需检查windows是否勾选add to path或macos/linux是否将which node路径写入shell配置并source；launch.json中program应设为"${file}"或显式入口路径；npm需配置国内镜像和自定义全局路径并重装工具。
Node.js 必须独立安装，VSCode 本身不提供运行时；调试失败、node 命令报错、nodemon 找不到——90% 都卡在这一步。
node -v 在终端里报 command not found 怎么办
这不是 VSCode 的问题，而是系统根本没认出 node。双击安装包点“下一步”不等于配置成功。
- Windows 用户：重装 Node.js 时务必勾选 Add Node.js to PATH；若已装完，手动把安装目录（如
C:\Program Files\nodejs）加进系统Path变量 - macOS/Linux 用户：用
brew install node后，确认which node输出路径已写入 shell 配置文件（~/.zshrc或~/.bash_profile），并执行source ~/.zshrc - VSCode 内置终端可能缓存旧环境变量：关掉所有 VSCode 窗口，重新打开项目文件夹再试
launch.json 的 program 字段为什么总调试失败
VSCode 自动生成的 launch.json 默认是 "program": "${workspaceFolder}/app.js"，但微服务入口往往叫 server.js、index.js 或 src/main.js，硬编码会导致 F5 直接崩溃。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 最稳妥写法是
"program": "${file}"—— 调试当前打开的文件，适合单文件快速验证 - 若项目有固定入口（如
src/index.js），显式写死路径："program": "${workspaceFolder}/src/index.js" - 别忘了：VSCode 不会自动保存未保存的文件，调试前务必按
Ctrl+S（Windows/Linux）或Cmd+S（macOS）
npm install 卡住 / nodemon 找不到命令
国内直连 npm 官方 registry 极大概率超时，且全局模块默认装在系统盘（C 盘），微服务本地开发常要同时跑多个进程，磁盘空间和网络稳定性直接影响效率。
- 换镜像：
npm config set registry https://registry.npmmirror.com - 改全局路径（例如放 D 盘）：
npm config set prefix "D:\npm-global"，再把该路径加进系统PATH - 改完后重装工具：
npm install -g nodemon，之后就能在任意目录用nodemon src/index.js - 关键验证点：
npm config get prefix和npm config get registry必须输出你设的值；如果系统终端能用nodemon，但 VSCode 终端不能，说明它没读取 shell 配置，重启 VSCode 或手动source ~/.zshrc更直接
微服务起步时最容易忽略的细节
微服务不是单个 index.js，它通常包含多进程、多端口、配置中心依赖。VSCode 调试器默认只 attach 单个进程，package.json 里的 scripts 往往比 launch.json 更灵活。
- 别只依赖 F5 调试：在
package.json中定义"dev": "nodemon --watch src --exec ts-node src/index.ts"（TypeScript 场景），然后用 VSCode 的Tasks或直接终端运行 - 多服务并行时，
concurrently比手开多个终端更可控，但它的输出日志会混在一起，调试断点仍得靠单进程 launch.json - 环境变量（如
NODE_ENV=development、PORT=3001）必须显式传给调试器："env": { "NODE_ENV": "development", "PORT": "3001" }，否则微服务常因读不到配置启动失败
