VS Code、PyCharm或IDEA中CodeGeex插件安装卡99%是因解压或注入失败，非下载问题；需彻底退出IDE、删除.extensions-tmp或插件缓存目录、清空Cache、修正locale.json为{"locale":"zh-hans"}（UTF-8无BOM），PyCharm/IDEA还须手动安装ZIP包且不解压，或执行Unblock-File解除Windows权限封锁。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeGeex 插件在 VS Code、PyCharm 或 IntelliJ IDEA 中安装时卡在 99%，不是下载未完成，而是解压或注入阶段被阻断——杀软拦截、临时目录被锁、权限不足、缓存损坏或插件与 IDE 版本不匹配都可能导致进度条静默挂起，且不报错、不超时、不重试。
VS Code 中安装卡 99%：清理 .extensions-tmp 并重置 locale
第一步：完全退出 VS Code。Windows 上打开任务管理器，结束所有 Code.exe 和 Code Helper 进程；macOS 用活动监视器搜索 “Code”；Linux 执行 ps aux | grep code 确保无残留。
第二步：删除临时扩展目录。Windows 路径为 %USERPROFILE%\.vscode\.extensions-tmp，macOS/Linux 路径为 ~/.vscode/.extensions-tmp。该目录若被杀软占用或权限异常，VS Code 就无法完成 .vsix 解压写入——删前必须确认进程已清空，否则删了也白删。
第三步：清空 VS Code 缓存。进入 %USERPROFILE%\AppData\Roaming\Code\Cache（Windows）或 ~/Library/Caches/com.microsoft.VSCode（macOS），删除整个 Cache 文件夹。不清缓存，VS Code 启动后会复用损坏的中间状态，继续卡住。
第四步：检查并修正 locale.json。中文界面不生效常因 locale.json 值错误。该文件位于 %APPDATA%\Code\User\locale.json（Windows）或 ~/.vscode/locale.json（macOS/Linux）。内容必须严格为：{"locale":"zh-hans"}——注意是短横线、全小写、无 BOM。用记事本保存时选“UTF-8 无 BOM”，否则 JSON 解析失败，界面直接回退英文。
PyCharm / IntelliJ IDEA 中安装卡 99% 或跳转 initialize 后失败
方法一：绕过市场网络限制，手动安装 ZIP 包
① 访问 CodeGeeX 官方 GitHub Release 页面（https://github.com/THUDM/CodeGeeX/releases），下载最新版 codegeex-pycharm-*.zip 或 codegeex-intellij-*.zip（务必认准文件名含 pycharm 或 intellij，别下错成 vscode 版）。
② 打开 PyCharm / IDEA → Settings → Plugins → 右上角齿轮图标 → Install Plugin from Disk…。
CodeGeeX 2.21.0是智谱AI推出的AI编程助手版本，对Inline Chat功能进行了重大优化，包括UI设计升级、支持流式输出以提升响应速度，并新增“查看思路”按钮以便理解代码原理。同时，该版本在编辑器中新增CodeLens控件，支持一键“解释”代码或“添加注释”。目前该工具对个人开发者免费开放。
③ 直接选中下载好的 ZIP 文件（⚠️切勿解压！解压后安装必失败）→ 点击 OK。
④ 弹窗提示重启 → 必须点击 Restart IDE，不能只点 Cancel 或 Close。
方法二：解除 Windows 权限封锁（仅限 PyCharm 用户）
若安装过程中在 aia\codex\bin\ 目录生成了 codex-acp-x64-windows.exe 但始终提示“初始化失败”，大概率是 Windows 将其标记为“来自互联网的文件”并阻止执行。在 PyCharm 自带 Terminal 中运行：Unblock-File "C:\Users\你的用户名\AppData\Local\JetBrains\PyCharm2025.3\aia\codex\bin\codex-acp-x64-windows.exe"。
运行成功后重新安装插件即可。
通用补救：清除插件缓存 + 强制重载环境
无论哪个 IDE，只要安装反复失败，就执行以下三步：
1. 关闭 IDE 全部窗口，包括托盘图标右键退出；
2. 删除对应插件缓存目录：
VS Code：%USERPROFILE%\.vscode\extensions\aminer.codegeex-*
PyCharm：%LOCALAPPDATA%\JetBrains\PyCharm2025.3\plugins\codegeex*
IntelliJ IDEA：%LOCALAPPDATA%\JetBrains\IntelliJIdea2025.3\plugins\codegeex*；
3. 在 IDE 设置中执行 File → Invalidate Caches and Restart → Invalidate and Restart。这一步会清空索引、日志、预编译缓存，避免旧配置干扰新安装。
