vscode 2026 强制调试适配器以独立进程运行，禁用 fork；必须启用 securetunnel、使用绝对 serverpath、升级至 dap v3.2 协议，且 compound 调试需统一插件版本。
调试适配器必须独立进程运行，否则启动即失败
VSCode 2026 强制要求所有调试插件的 Debug Adapter 必须以独立进程方式启动，child_process.fork() 被明确禁止。旧版 cortex-debug 或自研 DAP 若仍用 fork 启动 GDB/OpenOCD 子进程，会直接触发 ERR_PLUGIN_NONCOMPLIANT 错误，且 IDE 不报具体堆栈——只在开发者控制台输出一行错误码后静默禁用插件。
实操建议：
- 将原 fork 逻辑替换为
child_process.spawn()，并确保子进程 stdin/stdout/stderr 显式重定向到 IPC 管道 - 在
package.json的contributes.debuggers中声明"adapterExecutableCommand"，而非内联启动逻辑 - 验证时运行
npx vsce validate --target vscode-2026 --strict，它会扫描所有fork调用并报错
launch.json 中的 secureTunnel 和 serverpath 是硬性开关
明文 JTAG/SWD 通信在 VSCode 2026 下默认被 SECURITY_BLOCK 中断，即使 OpenOCD 配置正确、硬件连接正常，调试会话也会卡在 “Launching…” 状态且无日志。这不是超时问题，而是 TLS 握手失败后协议层直接丢弃请求。
实操建议：
- 必须在 launch.json 配置中显式设置
"secureTunnel": true，值为false或缺失均不通过校验 -
"serverpath"必须是绝对路径（如"/opt/openocd/bin/openocd"），且该二进制需具备CAP_NET_BIND_SERVICE权限（Linux）或已签名（macOS） - 若使用自定义 DAP，其响应
initialize请求时必须在capabilities字段中返回"supportsSecureTunnel": true
旧版插件手动改 engines.vscode 只能绕过安装检查，不能解决 DAP 协议断裂
把 "engines": {"vscode": "^1.78.0"} 改成 "^1.78.0 || ^1.96.0" 确实能让插件出现在 Extensions 视图里，但只要它底层仍用 DAP v1.42 协议与 VSCode 通信，就会出现“调试窗口打开但无断点命中”“变量视图空白”“Step Over 无响应”等静默失效现象——因为新版 IDE 已彻底移除对旧 DAP 消息字段（如 threadId 在 stackTrace 响应中的语义）的兼容解析。
实操建议：
- 仅当插件作者已发布支持 DAP v3.2 的版本（如
cortex-debug@0.4.13）时，才值得修改engines并启用 - 若插件无更新（如某些小众 J-Link 封装），必须重写其
debugAdapterDescriptor，将旧协议封装进符合 DAP+ v2.0 接口的 wrapper 进程中 - 不要依赖
Developer: Reload Window来验证——DAP 连接失败不会抛异常，只会让调试面板保持 loading 状态
compound 调试组合中混用新旧 type 会导致 targetArchitecture 解析失败
在跨端调试配置里，如果一个 compounds 同时包含 "type": "cortex-debug"（已适配 DAP v3.2）和 "type": "cppdbg"（仍用旧版 ms-vscode.cpptools v1.15），VSCode 2026 会在初始化阶段拒绝整个 compound，报错信息极简：Invalid debug configuration: unknown target architecture。这个错误不是来自任一子配置，而是网关层在统一协商架构语义时发现冲突。
实操建议：
- 检查所有 compound 中引用的 configuration，确保它们使用的插件都已通过
vsce verify认证（见知识库表格） - 临时方案：拆分为两个独立 launch 配置，手动切换调试目标，避免 compound 层级的协议混合
- 若必须共存，可降级
cpptools到 v1.14.9（最后支持 DAP v1.x 的稳定版），但需同步关闭enableModules等 C++26 特性，否则 Clangd 会因模块路径未注册而崩溃
