codegeex在idea 2021.3～2024.1.7旧版本无法安装的根本原因是plugin.xml中until-build字段拦截了低构建号，需确认构建号是否低于223，若≥223则可手动修改until-build值并重打包zip后强制安装。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你在 IDEA 2021.3～2024.1.7 之间某个旧版本里装不上 CodeGeeX，插件市场搜不到、点安装没反应、或者提示“不兼容当前 IDE 版本”，根本不是你操作错了，而是插件包的 【plugin.xml 中的 until-build 字段硬性拦截了你的构建号】，连加载入口都被 IDE 主程序直接拒之门外。
确认你的 IDEA 构建号是否被拦在门外
打开 IDEA → Help → About → 查看右下角 Build 字段，例如显示 IU-233.14475.28，其中 233 就是主构建号；CodeGeeX v2.27.4-223 的兼容范围是 2022.3～2025.3.6，对应构建号约 223.*～253.*；如果你的构建号低于 223（比如 213.*、212.*），说明你用的是 2021.x 系列，官方插件包压根不认你。
这一步必须做，别跳过——很多用户误以为是网络或权限问题，其实只是构建号太老，IDE 连解析 plugin.xml 的机会都不给。
手动修改插件包的兼容声明（仅限构建号 ≥223 的旧版）
方法一：解压 → 改 plugin.xml → 重打包
第一步：从官网或可信渠道下载 CodeGeeX 最新兼容旧版的离线包（如 v2.27.4-223.zip），不要用市场自动下载的，那已经是封禁版。
第二步：用 7-Zip 或 WinRAR 右键解压该 zip 包到一个空文件夹，不要双击打开，否则某些压缩工具会只读挂载。
第三步：进入解压后目录 → 找到 【META-INF/plugin.xml】，用 VS Code 或记事本打开它。
第四步：定位到 <idea-version since-build="223" until-build="253.*"></idea-version> 这一行，把 until-build="253.*" 改成你当前 IDEA 的构建号上限，例如你的 Build 是 IU-241.18065.18，就改成 until-build="241.*"；注意星号不能丢，也不能写成具体数字，否则 IDE 启动时报 schema 错误。
第五步：保存 plugin.xml，然后全选文件夹内所有内容 → 右键 → “添加到 archive” → 格式选 zip → 命名为 codegeex-fixed.zip（名字不能含中文或空格）→ 确保“存储”模式（非“压缩”），避免 ZIP 结构损坏。
强制安装补丁版插件
打开 IDEA → File → Settings → Plugins → 右上角 ⚙️ → Install Plugin from Disk… → 选择你刚生成的 codegeex-fixed.zip → 点 OK → 等待安装完成 → 提示重启时务必点击 Restart IDE。
重启后若仍报错“Plugin not compatible”，说明你改错了 until-build 值，或压缩包结构异常；此时请检查 zip 是否包含多余父级文件夹（正确结构应是 META-INF/ 开头，而非 codegeex-fixed/META-INF/）。
安装成功后，状态栏右下角会出现 CodeGeeX 图标，点击即可唤出 AI 聊天面板。
