codegeex侧边栏空白/黑屏/按钮堆叠是新版vscode渲染机制与旧webview实现兼容问题，非插件损坏；主因是css隔离失效、颜色继承错乱或透明背景干扰，windows深色主题+gpu加速下最显著。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeGeeX 插件的侧边栏点击后空白、内容不加载、按钮堆叠成一行或整个区域变黑，不是插件坏了，而是新版 VSCode 渲染机制与旧版 Webview 实现之间出现了 CSS 隔离失效、颜色继承错乱或窗口透明背景干扰。这类问题在 1.89+ 版本中集中爆发，尤其在 Windows 深色主题 + GPU 加速开启环境下最明显。
确认是否为 CodeGeeX 专属渲染异常
先排除通用侧边栏消失问题：按 Ctrl+B（Windows/Linux）或 Cmd+B（macOS），看左侧活动栏（Explorer/Search/Git 图标列）是否出现。如果活动栏本身也消失了，说明是 VSCode 全局设置或快捷键冲突，应先按常规流程恢复活动栏；如果活动栏正常但 CodeGeeX 侧边栏点开后为空白/全黑/按钮横向挤在一起，才进入本教程的修复路径。
打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P），输入并执行 Developer: Toggle Developer Tools，切换到 Console 标签页。点击 CodeGeeX 侧边栏图标，在控制台观察是否有报错——若出现 Failed to load resource: net::ERR_FILE_NOT_FOUND 或 Refused to apply inline style，说明 Webview 资源加载失败或样式被 CSP 拦截，属于 CodeGeeX 自身打包缺陷；若无任何报错但 DOM 中 webview 元素存在且 src 属性指向一个 vscode-webview:// URL，则问题出在 CSS 渲染层。
强制启用不透明窗口背景（Windows 用户必做）
这是解决 CodeGeeX 左侧栏“纯黑不可见”的最直接手段。该问题本质是 Electron 窗口透明背景与深色主题文字颜色未同步导致的渲染失效，不是插件 bug，而是系统级兼容问题。
打开 CodeGeeX 设置界面：点击左下角齿轮图标 → Settings → Appearance。
找到选项 Use opaque window background，将其开关打开。这会禁用毛玻璃/亚克力透明效果，让窗口背景强制使用纯色渲染，从而触发文字颜色重计算。
【必须重启 CodeGeeX 客户端才能生效】——仅刷新 VSCode 窗口无效，需完全退出再启动。
替换 CodeGeeX 内置 Webview 的 CSS 主题注入逻辑
CodeGeeX 1.6.x 及更早版本在构建侧边栏 HTML 时，硬编码了深色模式下的 background: #000 和 color: #000，未监听 VSCode 主题变更事件。当用户切换为浅色主题时，CSS 未更新，造成黑底黑字。
方法一：临时覆盖样式（无需修改源码）
在 VSCode 中按 Ctrl+Shift+P，输入并执行 Preferences: Configure Runtime Arguments，在打开的 argv.json 文件中添加：
"disable-color-correct-rendering": true
保存后重启 VSCode。此参数会关闭 Chromium 的颜色校正管线，强制使用原始 CSS 值，对 CodeGeeX 黑底问题有立竿见影效果。
方法二：手动修补 Webview 注入脚本（进阶）
定位 CodeGeeX 插件安装目录：
Windows：%USERPROFILE%\.vscode\extensions\codegeex.codegeex-*
macOS：~/Library/Application Support/Code/User/globalStorage/codegeex.codegeex/
Linux：~/.vscode/extensions/codegeex.codegeex-*/
找到 dist/webview/ 下的主 HTML 文件（如 sidebar.html），用文本编辑器打开，在 内插入以下代码：
<script>document.body.style.backgroundColor = getComputedStyle(document.documentElement).getPropertyValue('--vscode-editor-background') || '#ffffff';</script>
这行脚本会从 VSCode 主题变量中实时读取背景色并应用，绕过插件自身写死的黑色值。
禁用冲突 UI 扩展并重置视图位置
某些 UI 增强类扩展（如 Customize UI、VSCode Great Icons、SynthWave '84）会劫持 .webview 容器的 z-index 或注入全局 !important 样式，导致 CodeGeeX 的 Webview 被压到不可见层级。
第一步：关闭所有非必要 UI 扩展
按 Ctrl+Shift+P → 输入 Extensions: Show Enabled Extensions → 点击右上角“筛选”图标 → 勾选 UI 类别 → 逐一禁用名称含 “UI”、“Theme”、“Icon”、“Customize” 的扩展。
第二步：重置 CodeGeeX 视图位置
仍通过命令面板，输入并执行 View: Reset View Locations。该命令会清除所有自定义视图锚点，强制 CodeGeeX 侧边栏回归标准 DOM 插入位置，避免因布局错位导致的渲染裁剪。
第三步：验证是否解决
重新启用已禁用的扩展，每次只启用一个，观察 CodeGeeX 侧边栏是否再次异常。一旦复现，立即停用该扩展并检查其 GitHub Issues 页面是否有已知的 Webview 兼容性报告。
