必须确认WebStorm版本≥241且启用ide.plugins.untrusted.repository.enabled=true，否则插件静默禁用；支持Marketplace在线安装、ZIP手动安装或离线插件目录复制三种方式。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在 WebStorm 中安装 CodeGeex 插件前，必须确认当前 IDE 版本与插件兼容，否则插件无法启用、功能异常甚至导致项目索引卡死；2024.3 及之后版本默认禁用非 JetBrains 官方签名插件，需手动开启信任策略。
确认 WebStorm 版本与插件兼容性
打开 WebStorm → Help → About，查看 Build Number（如 243.22562.242），【CodeGeex 插件 v2.12.0 起仅支持 Build 241+ 的版本】。若版本低于 241（例如 233.x 系列），安装后插件图标不显示、设置页无入口，且无法通过重装修复。
启用非官方插件信任策略
关闭所有项目 → Help → Find Action（Ctrl+Shift+A）→ 输入「Registry」→ 回车打开注册表 → 找到「ide.plugins.untrusted.repository.enabled」→ 将其值设为 true → 重启 WebStorm。
这一步不可跳过。未启用时，即使从插件市场下载 ZIP 手动安装，WebStorm 也会在启动时静默禁用该插件，并在日志中输出「Plugin marked as untrusted」，但界面上不提示任何错误。
安装 CodeGeex 插件的三种方式
方法一：通过 Marketplace 在线安装（推荐）
File → Settings → Plugins → Marketplace → 搜索「CodeGeex」→ 点击 Install → 安装完成后勾选启用 → Restart IDE。
方法二：手动下载 ZIP 安装
进入 https://plugins.jetbrains.com/plugin/23382-codegeex → 下载最新 .zip 文件 → Settings → Plugins → ⚙️ → Install Plugin from Disk → 选择 ZIP → 重启。
方法三：离线安装（适用于内网环境）
第一步：在可联网机器上用相同 WebStorm 版本执行方法一，安装后进入 Plugins 页面 → 点击 CodeGeex 右侧「…」→ Show Plugin Directory；
第二步：复制整个插件文件夹（含 META-INF 和 lib 子目录）；
第三步：将该文件夹粘贴至目标机器的 【~/.WebStorm2024.3/config/plugins/（macOS/Linux）或 C:\Users\{user}\AppData\Roaming\JetBrains\WebStorm2024.3\plugins\（Windows）】 目录下；
第四步：重启 WebStorm 并在 Plugins 列表中手动启用。
