DAP握手失败导致调试会话“静默崩溃”，根本原因是initialize请求未收到合规响应（含seq、request_seq、success:true及body.capabilities），VSCode据此判定适配器不可用而直接放弃后续流程，不报错、无日志、断点变空心、工具栏不出现。
为什么 DAP 握手失败会导致调试会话“静默崩溃”？
DAP 握手失败不是报错后退出，而是让 VSCode 根本不启动调试会话——你点 F5，控制台没日志、断点变空心、调试工具栏不出现。根本原因在于 initialize 请求未收到合规响应，VSCode 就判定适配器不可用，直接放弃后续流程。
常见现象包括：ERR [DAP] handshake timeout after 15s — missing 'debugAdapterProcessId' header、launch.json 配置正确但无任何反应、Output → Log (Extension Host) 中出现 Failed to start debug session 却无堆栈。
-
initialize响应缺失或字段不全（必须含seq、request_seq、success: true、body.capabilities） - 适配器进程启动后立即退出（比如 Node.js 脚本里
process.exit(0)写在了初始化逻辑前） - stdin/stdout 管道未保持打开：DAP 是基于标准流的 JSON-RPC，适配器一结束 stdin 读取就中断，VSCode 认为连接已断
- VSCode v1.97+ 默认启用 DAP v3.2，但旧版适配器仍按 v2.x 返回响应，缺少
debugAdapterProcessId头字段
如何验证 DAP 握手是否真正跑通？
别等断点命中——最底层的日志才是唯一可信依据。重点看适配器进程的 stdin/stdout 收发内容，而不是 VSCode UI 表现。
- 在适配器入口加原始日志：
process.stdin.on('data', d => console.error('[IN]', d.toString()))；process.stdout.write(...)前也加console.error('[OUT]', ...) - 若用
vscode-debugadapter库，构造LoggingDebugSession时传入{ logFile: './dap.log' }，日志会包含完整 request/response 及时间戳 - 手动模拟握手：在容器或远程主机上执行
curl -v --http2 -H"Content-Type: application/json" --data'{"command":"initialize","arguments":{"clientID":"vscode","adapterID":"go"}}' http://localhost:5000/v3/debug/attach，观察返回是否为 HTTP/2 200 + 合规 JSON
launch.json 和 package.json 的 type 不一致会怎样？
这不是配置错误，是协议注册断裂——VSCode 根本不会把调试请求路由到你的插件。
-
package.json中contributes.debuggers.type值（如"mylang"）必须与launch.json里"type": "mylang"完全一致，大小写、连字符、空格都不能差 - 漏掉
"activationEvents": ["onDebugResolve:mylang"]，插件压根不激活，activate()函数不执行，适配器进程根本不会启动 - 如果用了自定义调试类型但没在
package.json中声明debuggers段，VSCode 会静默忽略该配置项，连 warning 都不抛
Dev Containers 场景下最容易被忽略的握手陷阱
容器环境放大了所有 DAP 层面的脆弱点，尤其是 TLS 和端口绑定这类“看不见”的环节。
- 调试进程监听地址写成
--inspect=127.0.0.1:9229，导致 VSCode 宿主机无法访问；必须是--inspect=0.0.0.0:9229 -
.devcontainer/devcontainer.json中"forwardPorts"必须是数字数组[9229]，写成字符串["9229"]会被 VSCode 忽略 - Docker Desktop v4.32+ 默认启用 containerd-shim TLS 拦截，会劫持 DAP v3.2 的 HTTP/2 流量，表现就是握手超时且无明确错误
- 工业现场或信创环境常禁用 TLS，但 VSCode 2026 默认要求
secureTunnel: true，需显式设为false并确认适配器支持明文 TCP
真正卡住调试的，往往不是逻辑 bug，而是某一行配置里少了个 0、多了一个引号、或者版本号对不上——这些地方没有语法高亮，也不报错，只默默让整个调试链路失效。
