启用 VSCode 的 Auto Attach 功能可实现 Node.js 进程启动即调试：一、全局启用 via Command+Shift+P → Debug: Toggle Auto Attach；二、项目级配置 launch.json 中设 "autoAttachChildProcesses": true；三、配合 node --inspect-brk 手动触发；四、用 NODE_OPTIONS='--no-inspect' 临时禁用。
如果您在使用 VSCode 进行 Node.js 应用开发时希望跳过手动附加调试器的步骤，直接在进程启动时自动进入调试状态，则可能是由于 Auto Attach 功能未启用或配置不匹配。以下是启用并正确使用该功能的具体操作：
本文运行环境：MacBook Air，macOS Sequoia。
一、启用全局 Auto Attach
VSCode 提供全局开关，允许所有 Node.js 子进程在启动时自动触发调试会话，无需修改代码或额外命令行参数。该功能依赖于 VSCode 内置的调试代理注入机制，适用于 spawn、exec、fork 等方式创建的子进程。
1、打开 VSCode 命令面板（快捷键 Command+Shift+P）。
2、输入并选择 Debug: Toggle Auto Attach。
3、确认状态栏右下角出现 Auto Attach On 提示。
二、通过 launch.json 配置项目级 Auto Attach
当需要为特定项目精确控制 Auto Attach 行为时，可在 .vscode/launch.json 中添加专用配置，避免影响其他工作区。此方式支持指定 node 路径、环境变量及超时策略。
1、在项目根目录下创建或打开 .vscode/launch.json 文件。
2、添加如下配置块：
3、确保 "autoAttachChildProcesses": true 字段存在且值为 true。
4、保存文件后，使用 F5 启动主调试会话，子进程将自动被附加。
三、使用 --inspect-brk 参数配合 Auto Attach
在某些 Node.js 版本或容器化环境中，仅开启全局 Auto Attach 可能无法捕获早期进程。此时需显式启用 V8 调试协议，并设置断点等待，再由 VSCode 主动连接。
1、在终端中运行 node --inspect-brk app.js 启动应用。
2、VSCode 将自动检测到监听中的调试端口并建立连接。
3、若未自动连接，可手动执行命令 Debug: Attach to Node Process 并选择对应进程。
四、禁用特定脚本的 Auto Attach
部分工具如 Jest、Mocha 或构建脚本可能因频繁 fork 导致调试器误附加，造成性能干扰。可通过环境变量临时关闭当前 shell 会话下的 Auto Attach 行为。
1、在终端中执行 export NODE_OPTIONS='--no-inspect'。
2、运行目标脚本，例如 npm test。
3、该环境变量将阻止 V8 检查调试标志，从而跳过 Auto Attach 流程。
