必须在vscode主窗口内按ctrl+shift+i（win/linux）或cmd+option+i（macos）才能打开渲染进程devtools；若焦点不在主窗口、被系统工具劫持或误在extension development host窗口使用，则快捷键失效或无法访问vscode api。
VSCode DevTools 打不开或快捷键失效怎么办
不是插件没装好，而是你按错了上下文。VSCode 的 Ctrl+Shift+I（Win/Linux）或 Cmd+Option+I（macOS）只对渲染进程生效，且必须确保焦点在 VSCode 主窗口内——如果弹出了“保存文件”对话框、系统级提示或外部窗口占了焦点，这个快捷键就完全没反应。
常见错误现象包括：按了没反应、弹出的是浏览器 DevTools 而非 VSCode 自身界面、Console 里 vscode 变量报 ReferenceError。
- 先用菜单路径兜底：
Help → Toggle Developer Tools - 确认没被键盘管理工具劫持（比如 Logi Options、Karabiner 等常会拦截
Ctrl+Shift+I） - 别在 Extension Development Host 窗口里误用这个快捷键——那是给插件 UI 用的，不是主编辑器
在 DevTools Console 里为什么调不到 vscode API
因为 VSCode 是 Electron 应用，主进程（处理文件系统、API 调用）和渲染进程（负责 UI 渲染）完全隔离。你在 DevTools 的 Console 里执行的代码运行在渲染进程，而 vscode.workspace、vscode.window.showInformationMessage 这类 API 只存在于主进程。
所以你看到 ReferenceError: vscode is not defined 是正常现象，不是配置错误。
- 想调试扩展逻辑？必须用
Launch Extension启动模式，在弹出的 Extension Development Host 窗口中再开 DevTools - 想查插件 UI 渲染问题？可以在 Extension Development Host 窗口里用
Ctrl+Shift+I，这时vscode依然不可用，但能 inspect 元素、看样式、打断点调试前端逻辑 - 真正要读取 workspace 配置或触发命令，得写在
activate()函数里，用console.log输出到 Extension Development Host 的 Debug Console（不是 DevTools Console）
如何定位插件 UI 卡顿或白屏
插件 UI 卡顿很少是 JS 执行慢，更多是同步阻塞、资源加载失败或 DOM 渲染异常。DevTools 的 Performance 和 Network 标签页在这里比断点更管用。
- 打开 DevTools 后切到
Performance，点录制 → 在插件 UI 上操作 → 停止，重点看主线程是否长时间黄色（JS 执行）、红色（强制重排） - 切到
Network，刷新插件 UI 页面，检查是否有404的 CSS/JS 资源（尤其注意路径拼错，比如用了./webview.js但实际打包后在dist/webview.js） - 如果 UI 白屏且控制台无报错，右键检查元素，看根节点是否存在；若存在但内容为空，大概率是 webview 的
html模板没正确注入或vscode-webview标签被 CSS 隐藏（比如display: none或height: 0）
插件 UI 日志该看哪几个地方
日志分散在三处，缺一不可。很多人只盯着一个地方，漏掉关键线索。
-
Developer: Open Logs Folder命令打开的目录（路径类似~/.vscode/logs/），里面main.log记主进程启动、插件加载失败；renderer.log记 UI 层崩溃 - Extension Development Host 窗口底部的
Debug Console，这里输出console.log和未捕获异常，对象结构深也能展开（比 DevTools Console 强） - 新窗口的 DevTools Console（即 Extension Development Host 里按
Ctrl+Shift+I打开的那个），这里能看到 webview 内部 JS 报错、跨域警告、eval被禁用等前端专属问题
最常被忽略的是 renderer.log —— 它不显示在任何面板里，但插件 UI 白屏、闪退时，十有八九它的第一行就写着 “Failed to load resource” 或 “SecurityError”。
