启用VSCode自动附加调试需开启Debug: Toggle Auto Attach，通过node --inspect-brk启动进程，处理端口冲突时指定唯一端口并配置autoAttachPortRange，排除干扰路径需设置autoAttachExclusions，确保直接调用Node.js避免shell封装。
如果您在VSCode中运行Node.js应用时希望无需手动配置launch.json即可自动启动调试器，则可能是由于Auto-attaching功能未启用或配置不匹配。以下是启用并正确使用该功能的步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、启用Auto-attaching功能
VSCode 1.83+内置了auto-attach机制，通过监听Node.js进程的--inspect标志自动连接调试器，无需预设配置文件。该功能依赖于VSCode后台调试代理与Node.js V8 inspector协议的实时握手。
1、打开VSCode命令面板（快捷键⇧⌘P）。
2、输入并选择Debug: Toggle Auto Attach。
3、确认状态栏右下角出现Auto Attach On指示图标。
二、通过终端启动支持调试的Node.js进程
Auto-attaching仅对显式启用V8 inspector的Node.js进程生效，需确保进程启动时携带--inspect或--inspect-brk参数，且端口未被占用。
1、在集成终端中执行：node --inspect-brk app.js。
2、若使用npm脚本，修改package.json中的scripts字段为："dev": "node --inspect-brk ./index.js"，再运行npm run dev。
3、进程启动后约1–2秒内，VSCode将自动弹出调试会话窗口并停在首行断点。
三、处理端口冲突导致的Attach失败
当多个Node.js进程同时尝试使用默认9229端口时，后启动的进程会因端口占用而无法被识别，此时需强制指定唯一调试端口并同步通知VSCode。
1、启动进程时指定非默认端口：node --inspect=0.0.0.0:9230 app.js。
2、在VSCode设置中搜索debug.javascript.autoAttachFilter，将其值设为always。
3、如仍失败，在设置中启用debug.javascript.autoAttachPortRange，添加范围如[9229, 9235]。
四、禁用特定目录的Auto-attach行为
某些项目（如含大量子进程的CLI工具）可能触发误Attach，需通过工作区设置排除干扰路径，避免调试器意外中断非目标进程。
1、在项目根目录创建.vscode/settings.json文件。
2、写入配置项："debug.javascript.autoAttachExclusions": ["**/node_modules/**", "**/dist/**"]。
3、重启VSCode窗口使设置生效。
五、验证Auto-attach是否响应进程启动
VSCode会在进程启动瞬间捕获--inspect元数据，若未响应，通常因进程派生方式绕过了主进程监听路径，需改用直接执行模式而非shell封装。
1、避免使用sh -c 'node --inspect app.js'等间接调用。
2、改用直接调用：node --inspect $(pwd)/app.js。
3、检查进程树：ps aux | grep inspect，确认输出中存在--inspect字样且无shell父进程包裹。
