首先配置 launch.json 文件实现 vscode 调试 node.js,设置 type 为 node、指定 program 入口文件,并将console 设为 integratedTerminal;然后通过 F5 或点击“启动程序”按钮运行调试,在代码行号旁点击添加断点,程序会在断点处暂停,支持查看变量、调用 栈等;若需附加到已运行的进程,使用 node –inspect 启动应用并在 launch.json中配置 request 为 attach、指定 端口9229,最后选择“附加到进程”即可连接调试。

在 VSCode 中调试 Node.js应用程序非常方便,只需简单配置即可实现断点调试、变量查看和控制台输出等功能。
启用调试功能
VSCode 内置了对 node.js 调试的支持,无需安装额外插件。确保你已安装 Node.js 环境,并可通过终端运行 node --version 验证。
打开你的 Node.js 项目,在 VSCode 左侧点击“运行和调试”图标(虫子图标),然后点击“创建一个 launch.json文件”。
配置 launch.json
VSCode 会提示选择环境,选择“Node.js”。这将在 .vscode 文件夹下生成 launch.json 文件。
常见配置如下:
{“version”: “0.2.0”, “configurations”: [ {“type”: “node“, “request”: “launch”, “name”: “ 启动程序 ”, “program”: “${workspaceFolder}/app.js”, “outFiles”: [“${workspaceFolder}/**/*.js” ], “console”: “integratedTerminal” } ] }
说明:
- type: 调试器类型,固定为
node - request:
launch表示启动应用,attach用于附加到已运行进程 - program: 入口文件路径,如
app.js或index.js - console: 推荐设为
integratedTerminal,可在终端中看到输出和交互
设置断点并开始调试
在代码行号左侧点击,添加断点(红点)。启动调试方式:
- 按 F5 键
- 点击“运行和调试”视图中的“启动程序”按钮
程序会在断点处暂停,此时可查看调用 栈、作用域 变量、表达式求值等。
附加到正在运行的进程
如果你已经通过命令行启动了 Node 服务,可以使用 attach 模式连接。
先运行应用:
node –inspect app.js
或监听特定 端口:
node –inspect=9229 app.js
然后在 launch.json 中添加配置:
{“type”: “node”, “request”: “attach”, “name”: “ 附加到进程 ”, “port”: 9229}
点击“附加到进程”即可连接调试。
基本上就这些。配置一次后,后续调试只需按 F5,VSCode 会自动加载设置。断点调试能大幅提升排查问题效率,建议在开发中经常使用。


