VSCode 2026日志插件迁移失败主因是API变更：logParser.register要求正则含命名捕获组且fields严格匹配组名；logService需显式启用v1兼容层；LogViewProvider须正确声明权限并触发resolveWebviewView；测试需手动引入vscode模块并确保类型版本≥1.98.0。
vscode.logParser.register 迁移失败：pattern 字段不生效
VSCode 2026 引入 vscode.logParser.register 后，旧版日志插件若仍用 vscode.languages.registerDocumentSemanticTokensProvider 手动解析，会丢失字段语义、高亮失效。根本原因是新 API 要求正则必须带命名捕获组（(?<field>...)</field>），且 fields 数组必须与组名严格一致。
实操建议：
- 检查你的正则是否含
(?<time>...)</time>类命名组，不能只用(...) -
fields数组顺序无关，但每个字符串必须是实际存在的组名，比如["level", "msg"]而非["severity", "message"] - 若原 pattern 是全局匹配（如
/^.*$/gm），需改写为单行匹配模式，否则注册失败无报错 - 在
activate中注册后，打开一个匹配扩展名的文件（如app.log），再看输出面板里Log Parser日志是否有 “registered” 提示
LogService v1 → v2 兼容层未启用导致写入失败
调用 vscode.logService.append 报错 TypeError: append is not a function，说明插件仍在用已废弃的 v1 接口。VSCode 2026 默认只暴露 v2 接口，v1 调用必须显式启用兼容层。
实操建议：
- 在插件
package.json的contributes下添加："logServiceCompatibility": "v1" - 确保
activationEvents包含onLogService，否则兼容层不加载 - v1 的
append(message, level)会被自动映射为 v2 的{ msg: message, level }，但自定义字段（如trace_id）会丢失，需改用 v2 的appendEntry({ msg, level, trace_id }) - 不要混用：同一插件中避免同时调用 v1 和 v2 写入方法，可能触发内部状态冲突
LogViewProvider 初始化黑屏或空白
使用 new LogViewProvider() 创建视图后，右键菜单里没有 “Open Log View”，或打开后 Webview 显示空白，常见于未正确声明 webview 权限或缺少 logView 激活事件。
实操建议：
- 确认
package.json中contributes.views已注册该视图 ID："my-log-view" - 在
activate里调用vscode.window.registerWebviewViewProvider前，确保context.subscriptions.push(...)已绑定生命周期 - Webview 的
html模板中，禁止直接内联<script></script>；必须通过webview.asWebviewUri加载外部 JS，否则被沙箱拦截 - 首次调试时，在 Webview 控制台执行
console.log(vscode.getState())，若返回undefined，说明LogViewProvider.resolveWebviewView未被触发
extensionTestsPath 启动失败：找不到 test runner
运行 code --extensionDevelopmentPath=$(pwd) --extensionTestsPath=./out/test 报错 Cannot find module 'vscode' 或 test runner not found，本质是 VSCode 2026 测试运行时不再自动注入 vscode 全局变量，需显式配置测试入口。
实操建议：
- 测试入口文件（如
./out/test/index.js）开头必须包含：const vscode = require('vscode');，不能依赖全局 - 确保
package.json的devDependencies包含@types/vscode@^1.98.0（版本号需 ≥ 当前 VSCode 版本） - 构建命令要先执行
npm run compile（或tsc），否则./out/test下无编译后 JS 文件 - 若用 Jest，需在
jest.config.js中设置setupFilesAfterEnv: ['<rootdir>/out/test/setup.js']</rootdir>，并在 setup.js 里手动 mockvscode实例
vscode.logParser 注册后是否真正挂载到编辑器实例上——它不报错，也不提示，只默默回退到纯文本渲染。打开一个日志文件，按 Ctrl+Shift+P 输入 “Developer: Toggle Developer Tools”，切到 Console 标签页，手动触发一次解析，才能看到真实链路是否断裂。 
