CodeGeeX 插件图标不显示、右键没反应，问题通常集中在几个常见原因上：VS Code 版本过低（至少需要 v1.85）、Java 运行时支持链路异常、扩展缓存损坏，或者与其他 AI 插件发生冲突。解决思路也很直接——覆盖更新 VS Code、清理 extensions 文件夹、暂时禁用同类插件，再手动触发 `CodeGeeX: Open Ask Panel` 命令并把活动栏图标勾选出来。

在 Windows 11 系统中安装 CodeGeeX 插件时，明明点击安装按钮后显示成功，图标却始终不出现，右键菜单毫无反应，侧边栏也找不到工具窗口，甚至重启 VS Code 后还提示“未启用”。别急着怀疑插件损坏——问题十有八九出在 VS Code 的运行环境、IDE 版本兼容性，或是 Java 运行时支持链路中断上。按照下面几步逐步排查，基本都能解决。

先验证 VS Code 是否为最新稳定版

CodeGeeX 高度依赖 VS Code 的语言服务协议（LSP）和扩展宿主机制。如果版本太旧（比如低于 v1.85），插件注册表缓存容易出异常，扩展激活时机也会错位——结果就是插件悄悄加载失败，没有任何提示。

打开 VS Code，点击左下角的齿轮图标，进入“帮助” → “检查更新”。如果有可用更新，直接下载安装；如果显示“已是最新”，最好手动前往 code.visualstudio.com 下载最新的 .exe 安装包，然后覆盖安装（覆盖安装会保留用户数据，省心省力）。

覆盖安装非常简单：双击新安装包运行就行，无需卸载旧版。装完后务必彻底关闭所有 VS Code 窗口（包括后台进程），再重新启动。

排查 IDE 内置 Java 运行时缺失（仅限部分功能）

CodeGeeX 在 VS Code 中虽然不强制要求本地 Java 环境，但它的“AskCodeGeeX”侧边栏、代码翻译、模型上下文分析等高级功能，底层依赖基于 JCEF（Chromium Embedded Framework）的渲染引擎。这个引擎需要 VS Code 自带的 Boot Runtime 来提供支持。如果 Java 运行时链路中断，侧边栏就无法正常打开。

方法一：强制刷新 Boot Runtime

按下 Ctrl+Shift+P 打开命令面板，输入 Developer: Open Boot Runtime Settings 并回车。在弹出的 JSON 文件中，确认 "java.home" 字段没有被手动注释或设成空值。如果该字段存在且指向已卸载的 JDK，直接删除整行，让 VS Code 自动回退到内置运行时。

方法二：手动触发 JCEF 初始化（适用于首次启用侧边栏失败）

打开一个真实项目文件夹（别在空窗口或欢迎页操作），在编辑器中新建一个 .py 或 .js 文件，随便输入几行代码并保存。然后再点击左侧活动栏的 CodeGeeX 图标。VS Code 只有在检测到有效的语言上下文后，才会真正加载插件的 UI 组件。

解决插件安装后“已启用”但无响应的问题

第一步：清除扩展缓存

关闭所有 VS Code 实例，按下 Win+R 输入 %USERPROFILE%\.vscode\extensions 并回车。找到以 codegeex.codegeex- 开头的文件夹，彻底删除（不要只重命名）。

第二步：禁用所有其他 AI 类插件

打开 VS Code，点击左侧扩展图标，在搜索框输入 @installed 查看已安装列表。暂时禁用 Codex、Tabnine、GitHub Copilot、Continue 等所有同类智能补全插件，只保留 CodeGeeX，然后重启 VS Code。

第三步：手动触发插件激活

按下 Ctrl+Shift+P，输入 CodeGeeX: Open Ask Panel 并回车。如果侧边栏弹出来了，说明插件实际上已经就绪，只是图标没有自动注册。此时右键活动栏空白处，勾选“CodeGeeX”，图标就会常驻显示。

注意：如果以上三步走完还是没反应，那大概率是当前用户配置文件损坏。可以新建一个 VS Code 用户配置：按 Ctrl+Shift+P，输入 Developer: New Window with Profile，选择“New Profile”，在新窗口中重新安装 CodeGeeX——这样能完全隔离原配置的干扰。