VSCode调试Node.js成功的关键是launch.json配置正确、node命令在PATH中、项目结构清晰；需验证node -v/npm -v输出版本，program字段用${workspaceFolder}绝对路径，TypeScript项目必须配sourceMaps且生成.map文件。

VSCode 本身不自带 Node.js 调试能力，但只要 launch.json 配置对、node 命令在 PATH 中、项目结构清晰，就能跑出接近 WebStorm 的调试体验——不需要装一堆插件，也不用改系统级配置。

确认 node 和 npm 能被终端识别

这是所有后续操作的前提。很多“调试不生效”“F5 没反应”的问题，根源都在这一步没走通。

• 在 VSCode 内置终端（Ctrl+`）里直接运行 node -v 和 npm -v，必须输出版本号；如果报 command not found，说明安装时没勾选“Add to PATH”，得重装 Node.js 或手动把 Node 安装目录（如 C:\Program Files\nodejs\ 或 /usr/local/bin）加进系统环境变量
• 不要依赖 PowerShell 或 Git Bash 单独验证——VSCode 终端默认用的是系统 shell，Windows 下通常是 cmd 或 Windows Terminal，macOS/Linux 是 zsh/bash，必须确保那个 shell 能识别 node
• nvm 用户注意：nvm use 只影响当前终端会话，VSCode 启动时不会自动执行它；建议用 nvm alias default 18.18.2 设个默认版本，或在 launch.json 里显式指定 runtimeExecutable

launch.json 必须写对这三处

VSCode 调试器靠它知道“从哪启动、传什么参数、在哪找源码”。模板自动生成的配置往往只适用于最简场景，稍一改动就断。

Rydberg Agent Node

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

下载

• "program"：必须是可执行入口的绝对路径或相对于 ${workspaceFolder} 的路径，比如 "${workspaceFolder}/src/server.js"；不能写成 "index.js" 或 "./index.js"（相对路径解析不稳定）
• "env" 和 "args" 要匹配你平时用命令行启动的方式，比如你习惯 npm start，那 "args" 就该是 ["--env", "development"]，"env" 里补上 "NODE_ENV": "development"，否则 process.env.NODE_ENV 可能是 undefined
• "skipFiles" 加上 ["<node_internals>/**"]</node_internals>，不然调试时会频繁跳进 node_modules 里的底层代码，打断思路；这个选项不是可选，是必开

调试时断点不命中？先查这三个地方

断点变空心圆、F5 启动后直接跑完没停——不是代码问题，大概率是源码映射或启动模式不对。

• 检查文件是否保存了：VSCode 默认“运行未保存文件”会失败，务必按 Ctrl+S 保存后再调试
• 确认你在用 "request": "launch" 模式（对应 F5），而不是 "request": "attach"（对应 “附加到进程”，需先手动 node --inspect-brk app.js）；两者混用是常见误操作
• TypeScript 项目必须配 "sourceMaps": true，且编译后的 .js 文件旁要有同名 .js.map；否则断点打在 TS 文件上，调试器找不到对应位置，直接忽略

不用插件也能做基础调试，但这些扩展真省事

官方 Node.js 支持已内置于 VSCode，但以下三个扩展能绕过大量手工配置：

• Node.js Extension Pack：含 ESLint、Auto Import、JavaScript Booster，自动补全 require 和 process.env 键名，比手敲快得多
• ESLint + .eslintrc.cjs：实时标红 console.log 漏删、callback 未处理错误等典型 Node.js 陷阱，比靠人眼扫更可靠
• Code Runner：右键 → “Run Code” 就能快速验证单个脚本，适合写工具函数或 CLI 小模块，不用反复改 launch.json

真正容易被忽略的，是 launch.json 里 "console": "integratedTerminal" 这一行——它决定了日志输出是否带颜色、是否可交互；设成 "internalConsole" 会导致 readline 输入卡死，而默认值又可能让 pm2 类进程无法正常退出。