答案：通过配置 launch.json 文件可在 VSCode 中高效调试 Node.js 应用。首先创建 launch.json 并设置 program 入口文件，使用 integratedTerminal 输出日志；在代码行号旁点击设断点，调试时查看变量、监视表达式和调用堆栈；支持条件断点以精准控制中断场景；对于已运行进程，通过 --inspect 启动应用并添加 attach 配置连接至 9229 端口；结合 nodemon 实现自动重启，启用 sourceMaps 支持 TypeScript 或 Babel 源码调试，并通过 env 配置环境变量，同时在 skipFiles 中忽略 node_modules 避免进入第三方代码，从而获得流畅调试体验。
要在 VSCode 中高效调试 Node.js 应用，不需要复杂的配置就能实现断点调试、变量监控和控制台交互。下面介绍从零开始的完整流程和实用技巧。
配置 launch.json 启动调试
VSCode 使用 .vscode/launch.json 文件定义调试配置。首次调试时需手动创建该文件。
步骤：- 打开你的 Node.js 项目根目录
- 点击左侧活动栏的“运行和调试”图标（虫子形状）
- 点击“创建一个 launch.json 文件”
- 选择环境为 Node.js
- VSCode 会生成默认模板，常见配置如下：
{
"version": "0.2.0",
"configurations": [
{
"type": "node",
"request": "launch",
"name": "启动应用",
"program": "${workspaceFolder}/app.js",
"outFiles": [
"${workspaceFolder}/**/*.js"
],
"skipFiles": [
"/**"
],
"console": "integratedTerminal"
}
]
} 说明：
- program：入口文件路径，如 app.js 或 server.js
- console：设为 integratedTerminal 可在终端中输出日志并交互
- skipFiles：跳过 Node.js 内部代码，避免误入系统模块
设置断点与查看变量
在编辑器左侧行号旁点击即可添加断点。启动调试后，程序运行到断点会自动暂停。
调试过程中你可以：- 在“变量”面板查看当前作用域中的变量值
- 将鼠标悬停在代码变量上快速查看其值
- 在“监视”面板添加表达式，如 obj.name 或 process.env.NODE_ENV
- 使用“调用堆栈”面板查看函数调用层级
提示：
右键断点可设置“条件断点”，例如只在某个用户 ID 下中断，适合处理循环或高频调用场景。
调试已运行的进程
有时服务已通过命令行启动（如 npm start），也可附加到该进程进行调试。
方法：- 修改 package.json，启动命令加入 --inspect 标志：
- 运行 npm run dev，控制台会显示调试地址（如 127.0.0.1:9229）
- 在 launch.json 中添加 attach 配置：
- 启动该配置，即可连接并调试正在运行的服务
实用技巧提升效率
- 自动重启调试：结合 nodemon 使用，在 launch.json 中将 runtimeExecutable 设为 nodemon，代码保存后自动重启调试会话
- 源码映射（Source Map）：如果你使用 TypeScript 或 Babel，确保编译时生成 .map 文件，并在 launch.json 中启用 "sourceMaps": true
- 环境变量支持：通过 env 字段传入环境变量：
- 忽略第三方代码：在 skipFiles 中添加 node_modules/** 可防止进入依赖库代码
基本上就这些。合理配置后，VSCode 能提供接近 IDE 级别的调试体验，关键是熟悉 launch.json 的选项并根据项目需求调整。不复杂但容易忽略细节，比如端口冲突或路径错误，检查控制台输出能快速定位问题。
