Auto Attach是VS Code中实现Node.js零配置调试的功能，通过在集成终端中自动附加调试器到node进程，支持Always、Smart和Only with flag三种模式，使用时需启用并重启终端，适用于npm scripts、CLI工具等场景。
VS Code 的 Auto Attach 功能是调试 Node.js 应用时非常实用的一项特性，尤其适合开发需要频繁启动和调试的项目。启用后，只要使用 node 命令运行脚本，VS Code 会自动附加调试器，无需手动配置 launch.json 或按 F5 启动调试会话。
Auto Attach 是什么？
Auto Attach 是 VS Code 中 JavaScript 和 TypeScript 调试器（由 @vscode/js-debug 提供）的一项功能，能够在 Node.js 进程启动时自动连接调试器。它利用环境变量和内部钩子机制，在进程创建时注入调试逻辑，实现“零配置”调试体验。
这项功能特别适用于：
- 使用 npm scripts 启动应用（如 npm start）
- 调试 CLI 工具、脚本或自动化任务
- 希望避免反复点击 F5 或修改命令行参数的场景
如何启用 Auto Attach？
启用步骤简单，只需在 VS Code 中进行一次设置：
- 打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P）
- 输入并选择：Debug: Toggle Auto Attach
- 选择一种模式：
- Always：对所有终端中的 node 进程启用自动附加
- Smart：仅在检测到项目中有 .vscode/launch.json 或相关调试上下文时启用
- Only with flag：仅当命令中显式传入 --inspect 类参数时启用（较保守）
推荐大多数用户选择 Always 或 Smart 模式，以获得无缝调试体验。
实际使用示例
假设你有一个简单的 Node.js 文件 app.js：
<font face="Courier New">console.log('Hello, Auto Attach!');
setTimeout(() => {
console.log('Breakpoint here? Yes!');
}, 1000);</font>
在终端中直接运行：
<font face="Courier New">node app.js</font>
如果 Auto Attach 已开启，VS Code 会在控制台输出出现时自动弹出调试工具栏，并允许你在代码中设置断点、查看调用栈和变量。无需添加 --inspect 参数，也不需要 launch.json。
注意事项与常见问题
虽然 Auto Attach 很方便，但也有一些细节需要注意：
- 必须使用集成终端（Integrated Terminal），外部终端不支持
- 某些 shell 或终端配置可能干扰环境变量注入，导致失效
- 如果项目中使用了 pm2、nodemon 等进程管理工具，可能需要额外配置才能正确附加
- 首次启用后，建议重启终端以确保环境变量生效
若发现未自动触发，可检查状态栏右侧是否显示“Auto Attach: On”，或重新执行切换命令确认状态。
基本上就这些。开启后，你会发现调试 Node.js 脚本变得像写日志一样自然。不复杂但容易忽略。
