VSCode运行Node脚本选什么调试模式_VSCode服务端断点【分享】-VSCode-PHP中文网

绝大多数情况应使用launch模式，即vs code自行启动node进程并注入调试器；仅当需调试已运行进程（如npm start或docker内服务）时才用attach模式。

vscode运行node脚本选什么调试模式_vscode服务端断点【分享】

VSCode 调试 Node.js 脚本，**绝大多数情况直接用 launch 模式就行**，不用纠结 attach 或 nodemon 集成——除非你明确需要热重载或复用已有启动命令。

关键不是“哪个高级”，而是“谁在控制生命周期”：

launch：VS Code 自己拉起 node 进程，适合单次脚本、CLI 工具、API 服务快速验证。断点稳、路径好配、环境干净。
attach：Node 进程已由终端（如 node --inspect-brk server.js）或 npm script（如 "debug": "node --inspect-brk index.js"）启动，VS Code 只连接。适合调试长时运行的服务、或必须走特定启动流程的场景。
别混用：比如在 launch 配置里把 program 写成 nodemon，VS Code 会尝试直接执行 nodemon 二进制，而不是让它启动子进程——结果要么报错，要么断点完全不生效。

这是断点不触发的第一大原因。VS Code 不会帮你编译、转译或解析入口，它只认 JS：

根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。

下载

TS 项目？program 必须是编译后的路径，例如 "${workspaceFolder}/dist/server.js"，不是 src/server.ts。
用 ts-node？可以，但得改 runtimeExecutable 为 ts-node，并确保 sourceMaps: true 和 outFiles 配对（否则断点停在 JS 行，和 TS 对不上）。
ESM 项目？加 "runtimeArgs": ["--loader", "ts-node/esm"]，且确认 ts-node 已全局或本地安装。
路径含空格？不用手动加引号，VS Code 自动处理；但若用了 args 数组，每个参数字符串得自己包引号，比如 "--port=3001"。

空心红点 = VS Code 找不到源码映射关系。不是代码问题，是配置没告诉它“JS 是从哪来的”：

TypeScript 必须同时满足三件事："sourceMap": true 在 tsconfig.json 中开启；"sourceMaps": true 在 launch.json 配置里启用；"outFiles": ["${workspaceFolder}/dist/**/*.js"] 明确输出路径（路径必须和实际构建产物一致）。
如果 .ts 文件不在根目录下（比如 packages/api/src），还得加 "resolveSourceMapLocations": ["${workspaceFolder}/packages/**/src/**", "!**/node_modules/**"]，不然它可能去 node_modules 里瞎找 map。
没配 outFiles，VS Code 就不知道该把 dist/index.js 的第 42 行映射回 src/index.ts 的哪一行——断点只能打在 JS 上，且大概率偏移。

看似和断点无关，实则常导致调试静默失败：

env 不继承终端：即使你在终端里 export PORT=4000，VS Code 调试器默认看不到。必须显式写进 launch.json 的 "env": {"PORT": "4001"}，尤其避免和本地已运行的 npm run dev 端口撞车。
skipFiles 别乱设宽泛路径：比如 "${workspaceFolder}/node_modules/**/*.js" 可能跳过你依赖里关键的调用链（像 knex 的 query 方法），导致断点“跳过”而非“不触发”。真要跳过，用更精确的 "<node_internals>/**"</node_internals> 就够了。
macOS/Linux 下 PATH 不生效？检查 VS Code 是不是从桌面图标启动的——它可能没加载 shell 的 PATH。在 VS Code 终端里跑 node -v 失败，就得在 .vscode/settings.json 里补全 "terminal.integrated.env.osx"。