VSCode 支持三种零配置 Node.js 调试方式：一、通过运行和调试侧边栏自动识别 package.json 中的 scripts；二、用命令面板选择 Node.js: Launch Program 调试当前打开的入口文件；三、在 npm script 中添加 –inspect-brk 标志后附加调试。
如果您在开发 Node.js应用时希望跳过繁琐的调试配置步骤，VSCode 提供了多种无需手动编写 launch.json即可启动调试的方式。以下是实现零配置调试的具体方法：
本文运行环境：MacBook Air，macOS Sequoia。
一、使用运行和调试侧边栏自动检测
VSCode 在打开包含 package.json 的 Node.js 项目时，会自动识别 scripts 字段中的 start、dev、test 等常见脚本，并将其作为可调试目标。该机制依赖于 TypeScript 或 JavaScript 语言服务的上下文感知能力，无需任何 launch.json 文件。
1、确保项目根目录下存在 package.json 文件，且其中 scripts 字段包含类似 ”dev”: “node index.js” 或 ”start”: “node app.js” 的条目。
2、点击左侧活动栏中的 运行和调试 图标（Ctrl+Shift+D）。
3、点击顶部的 运行脚本 下拉菜单，选择对应 script 名称（如 dev）。
4、点击绿色三角形按钮启动调试，断点将直接生效。
二、通过命令面板快速启动调试
VSCode 内置的 Node.js 调试器支持基于当前打开文件的即时调试，适用于单文件脚本或入口文件明确的项目。此方式完全绕过 launch.json，由编辑器自动推导运行参数。
1、确保当前编辑器中打开的是 Node.js 入口文件（如 index.js、server.js 或 app.js）。
2、按下Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux）打开命令面板。
3、输入并选择Debug: Select and Start Debugging。
4、在弹出选项中选择Node.js: Launch Program，系统将自动生成临时调试配置并立即运行。
三、利用 npm script 集成调试协议
通过在 npm script 中注入 –inspect 标志，可使 Node.js 进程暴露调试端口，VSCode 则通过附加模式连接该端口。该方法不修改项目结构，也不依赖 launch.json，仅需调整脚本定义。
1、编辑 package.json，在 scripts 中将目标脚本修改为：“dev”: “node –inspect-brk index.js”。
2、在终端中执行 npm run dev，等待控制台输出类似Debugger listening on ws://127.0.0.1:9229/… 的信息。
3、打开 VSCode 命令面板，执行Debug: Attach to Node Process。
4、从进程列表中选择刚启动的 node index.js 进程并确认。
