VSCode调试Node.js可启用自动附加功能避免手动操作：一、在launch.json中配置autoAttachChildProcesses；二、全局开启Debug: Toggle Auto Attach；三、npm script配合Auto Attach On；四、指定端口精准控制附加。
如果您在使用 vscode 调试 node.js 应用时反复手动启动调试器并附加到进程，可能是因为未启用或未正确配置“自动附加”功能。该功能可让 vscode 在检测到 node.js 进程启动时自动连接调试器，省去手动操作。以下是启用与配置该功能的具体方法：
本文运行环境：MacBook Air，macOS Sequoia。
一、通过 launch.json 启用自动附加
此方法通过修改调试配置文件，使 VSCode 在启动调试会话时自动启用附加监听，并在子进程启动时自动连接。
1、在项目根目录下打开 .vscode/launch.json 文件；若不存在，则点击调试侧边栏的齿轮图标生成默认配置。
2、在 configurations 数组中添加一个 type 为 "node" 的配置项，设置 "request": "launch"，并添加 "autoAttachChildProcesses": true。
3、确保 "console": "integratedTerminal" 或 "externalTerminal" 已设置，以便在终端中启动带调试标志的进程。
4、保存文件后，在集成终端中运行 node --inspect-brk app.js，VSCode 将自动识别并附加调试器。
二、全局启用 auto attach 模式
此方法将 VSCode 设置为始终监听本地 9229 端口上的调试请求，适用于任意通过 --inspect 或 --inspect-brk 启动的 Node.js 进程。
1、按下 Cmd+Shift+P（macOS）或 Ctrl+Shift+P（Windows/Linux）打开命令面板。
2、输入 Auto Attach 并选择 “Debug: Toggle Auto Attach”。
3、状态栏右下角出现 Auto Attach On 即表示已启用。
4、此时在终端中执行 node --inspect app.js，VSCode 将在几秒内自动附加调试会话。
三、使用 npm script 配合自动附加
此方法通过封装调试启动命令，结合 VSCode 自动附加机制，实现一键调试 npm 启动的 Node.js 服务。
1、在 package.json 的 scripts 字段中添加： "debug": "node --inspect-brk ./index.js"。
2、确保 VSCode 处于 Auto Attach On 状态。
3、在集成终端中运行 npm run debug。
4、VSCode 将立即捕获调试请求，并在断点处暂停执行，无需额外配置 launch.json。
四、禁用自动附加时的精准控制
当多个 Node.js 进程同时运行导致误附加时，可通过指定端口和进程 ID 实现精确匹配，避免干扰。
1、在终端中启动 Node.js 进程时显式指定调试端口：node --inspect=0.0.0.0:9230 app.js。
2、在 launch.json 中添加配置，设置 "port": 9230 和 "address": "localhost"。
3、设置 "skipFiles": ["
4、启动调试后，VSCode 仅连接至明确声明端口的进程，不会响应其他端口的 --inspect 请求。
