在Fedora系统安装CodeGeex插件前，须先解决Python版本兼容性（3.9–3.11）、pip用户级安装、Development Tools及python3-devel等编译依赖，并通过指定PyTorch wheel或预编译whl包安装，最后验证torch与codegeex模块可正常导入。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在 Fedora 系统下安装 CodeGeex 插件前，必须先解决 Python 依赖缺失问题，否则插件启动即报 ModuleNotFoundError 或 ImportError，根本无法加载代码补全、解释等功能。
确认系统 Python 版本与 pip 状态
打开终端，执行：python3 --version 和 pip3 --version。Fedora 39+ 默认使用 Python 3.12，但部分旧版 CodeGeex（如 v2.1.1）仅兼容 Python 3.9～3.11。若版本不匹配，【必须降级或创建兼容虚拟环境】，硬装会导致后续所有功能崩溃。
检查 pip 是否为系统自带版本：运行 which pip3。若输出为 /usr/bin/pip3，说明未启用用户级 pip；此时直接 pip install 可能因权限被拒或污染系统包，建议优先用 pip3 install --user 方式安装。
安装基础编译与科学计算依赖
Fedora 默认不预装 Python 编译工具链和 BLAS/LAPACK 数学库，而 CodeGeex 的底层依赖（如 torch、transformers）在安装时需本地编译扩展模块。
执行以下命令一次性装齐：sudo dnf groupinstall "Development Tools" → sudo dnf install python3-devel openblas-devel lapack-devel gcc-gfortran
这一步跳过会导致 pip install accelerate 或 torch 时卡在 building 'torch._C' 阶段，报错信息里频繁出现“fatal error: Python.h: No such file or directory”，实际就是缺 python3-devel。
安装 CodeGeex 运行所需核心依赖
方法一：从官方仓库克隆后安装（推荐用于调试或定制部署）
进入 CodeGeex 项目目录（如已克隆至 ~/CodeGeex），执行：cd ~/CodeGeex && pip3 install --user -r requirements.txt
CodeGeeX 2.21.0是智谱AI推出的AI编程助手版本，对Inline Chat功能进行了重大优化，包括UI设计升级、支持流式输出以提升响应速度，并新增“查看思路”按钮以便理解代码原理。同时，该版本在编辑器中新增CodeLens控件，支持一键“解释”代码或“添加注释”。目前该工具对个人开发者免费开放。
注意：Fedora 的 requirements.txt 中若含 torch，请勿直接 pip install —— 官方 PyPI 上的 torch 不支持 Fedora 的 glibc 版本。必须改用官方提供的 Linux wheel：pip3 install --user --force-reinstall --no-deps torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu（CPU 版）或 --index-url https://download.pytorch.org/whl/cu121（NVIDIA GPU 版，需先装 nvidia-driver 和 cuda-toolkit）。
方法二：跳过源码，直接安装打包好的 wheel（适合快速启用插件）
访问 CodeGeex GitHub Releases 页面，下载对应 Fedora 架构的 codegeex-*.whl 文件（如 codegeex-2.4.0-py3-none-any.whl），然后运行：pip3 install --user ./codegeex-2.4.0-py3-none-any.whl
该方式绕过 requirements.txt 解析，避免因某一个依赖版本冲突导致整包失败。但需确保 wheel 内已静态包含 transformers、accelerate 等子依赖，否则仍会缺模块。
验证依赖是否完整生效
第一步：启动 Python 交互环境：python3 -c "import torch; print(torch.__version__)"。无报错且输出版本号，说明 torch 可加载。
第二步：模拟插件加载路径：python3 -c "from codegeex import CodeGeexModel; print('OK')"。若提示 ModuleNotFoundError: No module named 'codegeex'，说明 wheel 未正确安装或 PYTHONPATH 未包含 --user 安装路径（通常是 ~/.local/lib/python3.x/site-packages）。
第三步：强制刷新 pip 缓存并重载路径：pip3 cache purge → export PYTHONPATH="$HOME/.local/lib/python3.$(python3 -c 'print($0.split()[1])')/site-packages:$PYTHONPATH" → 再次执行第二步验证。
