怎么在VSCode中关联Node并运行后台服务 - 基础配置指南-VSCode-PHP中文网

vscode调试node.js失败90%因node命令不可达或program路径错误；必须先验证终端中node -v可用，再确保program为${workspacefolder}开头的绝对路径，typescript项目需配sourcemaps或ts-node，web服务推荐attach模式。

怎么在vscode中关联node并运行后台服务 - 基础配置指南

VSCode 本身不运行 Node.js，它只负责启动、连接和调试；真正执行服务的是你本地安装的 node 进程。关联失败的绝大多数情况，不是配置写错了，而是 node 命令根本没进 VSCode 终端的环境变量里——这点必须先确认，否则所有后续操作都是徒劳。

node 命令在 VSCode 终端里是否真可用？

这不是“系统终端能跑就算数”的问题。VSCode 内置终端（Ctrl + `）可能用的是 PowerShell（Windows）、zsh（macOS）或 bash（Linux），而你的 node 路径很可能只加在某个 shell 的初始化文件里，没被 VSCode 加载。

在 VSCode 终端里直接运行 node -v 和 npm -v，必须有输出（如 v20.11.1、10.5.0）；报 command not found 就停在这一步，别往下配 launch.json
macOS/Linux：检查 ~/.zshrc 或 ~/.bash_profile 是否含 export PATH="/opt/homebrew/bin:$PATH"（Homebrew 安装路径）或 /usr/local/bin（手动安装路径）；改完后执行 source ~/.zshrc，再彻底退出 VSCode，从终端用 code . 启动
Windows：重装 Node.js 时务必勾选 Add to PATH；或者手动把 C:\Program Files\nodejs\ 加进“系统变量 > PATH”；改完后必须彻底关闭所有 VSCode 进程再重开

launch.json 中 program 字段怎么写才有效？

program 是调试器找入口的唯一依据，它必须指向一个真实存在的、能被 node 直接执行的 .js 文件。写错路径、混用源码和编译产物、漏掉 ${workspaceFolder}，断点就会变灰、调试器提示 “Cannot find module” 或 “Cannot launch program”。

Rydberg Agent Node

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

下载

后端项目不要用 "program": "${file}"（仅适合单文件临时测试）；应显式写成 "program": "${workspaceFolder}/app.js" 或 "program": "${workspaceFolder}/src/server.js"
TypeScript 项目：program 必须指向编译后的 .js 文件（如 dist/server.js），不能指 src/server.ts；同时确保 tsconfig.json 含 "sourceMap": true，且 .js.map 和 .js 在同一目录
ESM 项目：必须在 package.json 里加 "type": "module"，否则 import 语句会按 CommonJS 解析失败
务必加上 "cwd": "${workspaceFolder}"，否则 require('./config')、读取 .env、静态资源路径都会出错

用 nodemon 热重载时怎么保持断点有效？

直接把 program 改成指向 nodemon 脚本，会导致调试器无法稳定附加，断点跳过、连接中断是常态。nodemon 不是替代 node 的运行时，而是进程管理器——调试必须走 attach 模式。

终端先手动运行：nodemon --inspect-brk src/server.js（端口默认 9229）

在 launch.json 新增一个 request: "attach" 配置，例如：

{
  "type": "node",
  "request": "attach",
  "name": "Attach to nodemon",
  "port": 9229,
  "address": "localhost",
  "restart": true
}

不要在 launch.json 里设 runtimeExecutable 指向 nodemon；旧版教程里那种写法在 VSCode 1.85+ 已不可靠
如果项目用 ts-node，优先用 "type": "pwa-node" + runtimeExecutable: "npx" + runtimeArgs: ["ts-node", "src/server.ts"]，比硬配 nodemon 更稳

最常被忽略的一点：VSCode 调试器对路径是字面量敏感的。"./src/server.js" 和 "src/server.js" 都不会被解析为工作区相对路径，只有 "${workspaceFolder}/src/server.js" 才行。哪怕多一个空格、少一个斜杠，断点就失效——这不是 bug，是设计如此。