VSCode调试Node.js应用程序终极指南

vscode调试node.js需掌握launch.json配置与三种模式：基础launch、attach已运行进程、nodemon热重载。关键字段包括type、request、program、port等，配合断点与sourceMap可高效定位问题。

VSCode 调试 Node.js 应用不难，关键在于配置对、启动准、断点稳。只要搞懂 launch.json 的核心字段和常见场景的调试模式，90% 的问题都能在编辑器里直接定位。

一、基础调试：自动配置 + F5 启动

新建 node.js 项目后，打开根目录，在命令面板（Ctrl+Shift+P / Cmd+Shift+P）中输入 Debug: Open launch.json，选择环境为 Node.js。VSCode 会自动生成一个默认配置，通常是：

• type: “node” —— 表示使用 Node 调试器
• request: “launch” —— 启动新进程调试（最常用）
• program: “${workspaceFolder}/index.js” —— 入口文件路径，按需修改
• console: “integratedTerminal” —— 输出显示在集成终端，方便看日志

保存后，设好断点（代码行号左侧单击），按 F5 就能跑起来。注意：确保已安装 Node.js 且 node -v 可执行。

二、调试已运行的 Node 进程（Attach 模式）

适合调试 express/Koa 等长期运行的服务，或想复用 npm script 启动方式时。先让程序以调试模式运行：

• 命令行启动：node --inspect-brk index.js（--inspect-brk 会在第一行暂停）
• 或用 npm script："debug": "node --inspect-brk index.js"，然后 npm run debug

再在 launch.json 中添加一个 Attach 配置：

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

运行这个配置，VSCode 就会连接到正在监听 9229 端口的 Node 进程。端口号要和 --inspect 后指定的一致（默认 9229）。

Flash Builder操作指南 中文WORD版

本文档主要讲述的是Flash Builder操作指南；Flash Builder将构成应用程序的资源（文件夹和文件）组合到一个容器中，我们将其称为项目。项目包含一组属性，这些属性控制应用程序的构建方式、构建的应用程序所在的位置、调试的处理方式以及该项目于工作空间中其他项目的关系。希望本文档会给有需要的朋友带来帮助；感兴趣的朋友可以过来看看

0

查看详情

三、用 Nodemon 自动重启 + 调试

开发时改完代码不想手动重启？把 Nodemon 和调试结合即可。先确保全局或本地装了 nodemon：npm install --save-dev nodemon。

在 launch.json 中写一个带 runtimeExecutable 的配置：

{   "type": "node",   "request": "launch",   "name": "Nodemon Debug",   "runtimeExecutable": "${workspaceFolder}/node_modules/.bin/nodemon",   "runtimeArgs": ["--inspect-brk", "${workspaceFolder}/index.js"],   "console": "integratedTerminal",   "restart": true,   "port": 9229 }

注意：runtimeArgs 里传 --inspect-brk 是为了让每次重启都停在第一行；VSCode 会自动等待端口就绪再连接。windows 用户若提示找不到 nodemon，可改用 nodemon.cmd 或用 npx nodemon 替代 runtimeExecutable。

四、常见卡点与对策

调试失败？大概率是这几个地方出了问题：

• 断点灰了（未命中）：检查是否在 transpiled 代码（如 typescript/Babel）上打点——应在源码（.ts/.jsx）打，配合 sourceMaps: true 和正确的 outFiles 路径
• “Cannot connect to runtime”：确认 Node 进程确实在监听调试端口；检查防火墙或杀毒软件是否拦截了 9229 端口
• 控制台无输出：看看 console 字段是不是设成了 internalConsole（旧版行为），建议统一用 integratedTerminal
• 调试器连上了但没反应：可能是 Node 版本太新（v20+），VSCode 旧版本支持不佳，升级到最新版 VSCode 即可

基本上就这些。配一次，后面所有项目复制粘贴改个 program 路径就能用。