VSCode 2026插件调试能力升级导致旧逻辑“错位工作”：debuggers.type须严格字符匹配、logService需启用v1兼容层、logParser.register强制要求命名捕获组与fields严格一致、LogViewProvider须显式声明权限并正确注册。
VSCode 2026 的插件调试能力已实质性升级，但旧版调试逻辑在新环境中大概率失效——不是“不工作”，而是“错位工作”：断点不触发、变量值为空、日志写入静默、Webview 初始化失败，这些都不是配置遗漏，而是 API 语义变更导致的隐性不兼容。
launch.json 中 debuggers.type 不再匹配就直接跳过注册
VSCode 2026 对 debuggers.type 的校验变严格：它不再容忍大小写混用、空格残留或前缀后缀干扰。例如你在 package.json 里声明了 "type": "mylang-debug"，但在 launch.json 里写了 "type": "MyLang-Debug"，VSCode 2026 就会完全忽略该配置，且不报任何错误提示。
- 检查
package.json中contributes.debuggers[].type的原始字符串，逐字符比对launch.json里的type字段 - 避免使用大驼峰（如
MyLangDebugger），统一用 kebab-case（mylang-debugger） - 如果插件支持多语言，确保每个
type在launch.json中有唯一、显式对应的配置块，不能靠 fallback 或默认值
vscode.logService.append 在 2026 默认不可用
调用 vscode.logService.append("msg", "INFO") 报 TypeError: append is not a function，是因为 VSCode 2026 已移除 v1 接口，仅暴露 v2。但 v2 不提供 append() 方法，改用 appendEntry()，且必须显式启用兼容层才能让旧代码继续运行。
- 在
package.json的contributes下添加："logServiceCompatibility": "v1" - 确保
activationEvents包含"onLogService"，否则兼容层根本不会加载 - v1 的
append(msg, level)会被映射为 v2 的{ msg, level }，但自定义字段（如trace_id）会被丢弃；若需保留，必须改用appendEntry({ msg, level, trace_id }) - 同一插件中禁止混用 v1 和 v2 写入方式，否则内部缓冲区状态可能错乱
logParser.register 要求命名捕获组与 fields 严格一致
旧插件用正则解析日志时习惯写 /^(\d{4}-\d{2}-\d{2}) (\w+): (.*)$/，然后传 fields: ["date", "level", "msg"] ——这在 VSCode 2026 下完全失效，logParser.register 会静默失败，且无控制台警告。
- 正则必须使用命名捕获组，例如：
/(?<time>\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2})(?<level>\s+\w+\s+):(?<msg>.*)/</msg></level></time> -
fields数组中的每个字符串，必须是正则中实际存在的命名组名（"time"、"level"、"msg"），不能是别名或拼写变形 - 正则不能设全局标志
g或多行标志m，否则注册失败且无提示；应按单行模式设计 - 注册后，打开一个匹配扩展名的日志文件（如
app.log），再查看输出面板中 “Log Parser” 频道是否有 “registered” 日志
LogViewProvider 初始化失败常因权限或事件缺失
新建 LogViewProvider 后右键无 “Open Log View”，或 Webview 打开为空白，多数情况不是代码写错，而是 VSCode 2026 强制要求显式声明权限并触发生命周期事件。
- 在
package.json的contributes.views下，对应 view 必须声明"type": "webview"且包含"enableScripts": true - 必须在
activate函数中调用vscode.window.registerWebviewViewProvider，并传入正确构造的LogViewProvider实例 - 不能只 new 实例而不注册；也不能在
resolveWebviewView外部提前调用webview.html = ...，否则内容无法注入 - 若使用
webviewOptions.localResourceRoots，路径必须为绝对 URI 格式（vscode.Uri.file(...)），相对路径或字符串路径将被忽略
最易被忽略的是：VSCode 2026 的调试适配器启动流程中，createDebugAdapterDescriptor 返回的 DebugAdapterExecutable 必须指向可执行文件，而不能是带参数的 shell 命令字符串；任何依赖环境变量或 shell 解析的路径，都应在适配器进程内自行处理，而非交由 VSCode 启动时展开。
