VSCode的Auto Attach功能支持五种启用方式：命令面板切换、设置界面配置、launch.json添加、环境变量设置及验证生效步骤，实现Node.js进程自动调试。
如果您在开发Node.js应用时希望无需手动配置调试器即可自动附加到进程，VSCode的Auto Attach功能可直接启用运行时调试支持。以下是启用与使用该功能的具体步骤：
本文运行环境：MacBook Pro，macOS Sequoia。
一、通过命令面板启用Auto Attach
此方法利用VSCode内置的调试命令快速开启全局自动附加模式，适用于临时调试场景，不修改任何配置文件。
1、按下 Cmd + Shift + P（macOS）或 Ctrl + Shift + P（Windows/Linux）打开命令面板。
2、输入 Debug: Toggle Auto Attach 并回车。
3、状态栏右下角将显示 Auto Attach: On 提示，表示已激活。
二、通过设置界面启用Auto Attach
此方式将Auto Attach设为默认行为，每次启动VSCode后持续生效，适合高频调试用户。
1、点击左下角齿轮图标，选择 Settings。
2、在搜索框中输入 auto attach。
3、找到 Debug > Node: Auto Attach 选项。
4、从下拉菜单中选择 on 或 smart（后者仅对通过 node 命令启动且未禁用调试的进程触发）。
三、通过launch.json配置启用Auto Attach
此方法提供更精细的控制粒度，允许按工作区或项目单独启用，避免影响其他Node.js项目。
1、在项目根目录下打开 .vscode/launch.json 文件；若不存在，可通过调试侧边栏点击齿轮图标生成。
2、在配置数组中添加如下对象：
{"type": "pwa-node","request": "attach","name": "Auto Attach","port": 9229,"autoAttachChildProcesses": true}
3、保存文件后，执行 npm run dev 或直接运行 node --inspect-brk index.js 启动应用。
四、通过终端环境变量启用Auto Attach
此方式绕过VSCode UI操作，在Shell层面统一控制Node.js子进程的调试行为，适用于CI/CD脚本或团队标准化配置。
1、在终端中执行：export NODE_OPTIONS='--inspect=0.0.0.0:9229'（macOS/Linux）或 set NODE_OPTIONS=--inspect=0.0.0.0:9229（Windows Command Prompt）。
2、随后在该终端会话中运行 node app.js。
3、VSCode将自动检测并连接至监听9229端口的Node.js进程。
五、验证Auto Attach是否生效
此步骤用于确认当前配置已正确触发自动附加机制，避免因端口冲突或权限问题导致调试失败。
1、启动一个带调试参数的Node.js进程，例如：node --inspect-brk server.js。
2、观察VSCode调试侧边栏顶部是否出现绿色暂停图标及进程名称。
3、检查调试控制台是否输出类似 Debugger attached. 的日志信息。
