大纲视图本身不控制侧边栏显示，但插件冲突会间接导致侧边栏区域渲染失败——尤其是当冲突插件劫持webview渲染通道或覆盖.activitybar样式时；需通过开发者工具查报错、检查workbench.activityBar.visible配置、禁用扩展验证，并注意Webview在新版VSCode中的CSS隔离与主题继承问题。
大纲视图本身不控制侧边栏显示，但插件冲突会间接导致侧边栏区域渲染失败——尤其是当冲突插件劫持了 webview 渲染通道或覆盖了 .activitybar 样式时。
确认是不是大纲插件真在“搞事情”
VSCode 的大纲（Outline）视图默认不提供独立侧边栏图标，它依附于资源管理器（Explorer）面板或通过命令调出。所谓“大纲插件”引发侧边栏空白，大概率是以下三类插件之一：自定义大纲增强插件（如 Document This、Outline Panel）、语言服务器配套 UI 插件（如某些旧版 Java Extension Pack 自带的侧边栏面板），或 Webview 类 AI 辅助插件（如 CodeGeeX、Codex）——它们常复用大纲数据，但自己实现完整侧边栏视图。
排查方法：
- 按
Ctrl+Shift+P输入Developer: Toggle Developer Tools，切换到Console标签页 - 点击疑似出问题的侧边栏图标（比如一个新出现的“Outline”或“AI”图标）
- 观察是否有
Failed to load resource: net::ERR_FILE_NOT_FOUND（资源路径错）、Refused to apply inline style（CSP 拦截）、或Webview is disposed（生命周期异常） - 若控制台安静，但 DOM 中
webview元素存在且src是vscode-webview://...，说明问题在 CSS 或主题注入层
workbench.activityBar.visible 与插件侧边栏的关系
很多用户误以为改 workbench.sideBar.visible 就能救回插件侧边栏，其实不是。这个配置只控制中间内容区（Explorer/Search/Git）是否展开；而插件注册的自定义侧边栏图标（如 CodeGeeX 的闪电图标）是否显示，取决于 workbench.activityBar.visible 是否为 true，以及插件自身是否成功注册了 views。
关键检查点：
- 打开
settings.json（Ctrl+Shift+P→Preferences: Open Settings (JSON)） - 确认没有
"workbench.activityBar.visible": false—— 这条一旦存在，所有插件侧边栏图标都会消失 - 确认没有
"workbench.sideBar.location": "right"之类非常规设置，某些老插件只适配left - 如果使用 Remote-SSH/WSL，必须检查远程环境的
settings.json，本地改了没用
Webview 渲染失败的典型 CSS 坑
新版 VSCode（1.89+）对 Webview 的 CSS 隔离更严格，尤其在 Windows 深色主题 + GPU 加速开启时，background: transparent 或未声明 color 的文本极易被渲染成全黑或全白。这不是插件代码写错了，而是主题继承链断裂。
常见表现与绕过方式：
- 侧边栏一片黑 / 一片白 / 按钮堆成一行：大概率是插件硬编码了
background: #000却没监听主题变更事件 - 解决方案：手动启用
"window.nativeTabs": false和"window.enableMenuBarMnemonics": false，降低渲染复杂度 - 更直接的临时修复：打开插件设置（齿轮图标 → Settings），找
Use opaque window background并设为true（CodeGeeX 1.6.x 必开） - 终极验证：终端运行
code --disable-extensions启动纯净版，再装回目标插件——若此时正常，说明是其他扩展（如Customize UI、vscode-icons）注入的全局 CSS 冲突了.webview容器
为什么开发者工具里能看到 webview 元素却看不到内容
这是最让人抓狂的情况：DOM 树里明明有 webview 节点，src 属性也正确指向 vscode-webview://xxx/...，但右键“检查元素”进不去内部，内容区纯白或纯黑。根本原因是 Electron 的 webview 在 VSCode 中被设为 guestinstance 模式，且默认禁用 DevTools 调试（除非插件显式调用 webview.webContents.openDevTools()）。
这时唯一可操作的路径是：
- 打开命令面板，执行
Developer: Toggle Shared Process，重启共享进程（有时能重置 Webview 渲染上下文） - 检查插件源码中
webview.html是否漏写了<meta http-equiv="Content-Security-Policy">，尤其缺少style-src 'unsafe-inline'会导致内联样式被拒 - Windows 用户重点关掉 GPU 加速：
code --disable-gpu启动，若此时侧边栏恢复，说明是显卡驱动 + Electron 渲染管线兼容问题 - 别指望靠刷新或重载解决——Webview 生命周期由 VSCode 主进程管理，
webview.dispose()后不重建，就永远空白
真正难处理的不是“找不到开关”，而是多个条件叠加：远程环境配置错位 + 主题 CSS 注入 + Webview CSP 策略收紧。这时候改一行 JSON 不管用，得进插件源码补一句 webview.options = { enableScripts: true } 才算真正动手修。
