CodeGeex编程语言模型下载设置指南（2025版）

许多开发者在用 CodeGeeX 生成代码时常遇到一个痛点：模型本身能力不弱，但针对 Python、Java、Go 等语言输出却总偏差——要么响应延迟明显，要么生成代码语法错位。这通常不是模型底层的问题，而是未正确加载对应语言的专用权重，或缺少语言标签触发逻辑。

确认当前模型是否原生支持目标语言

首先在 VS Code 中点击左侧火箭图标（CodeGeeX），进入「Settings」，滚动到底部查看「Supported Languages」列表。该列表明确展示了当前加载模型原生支持的语言范围。【若目标语言未出现在列表中，后续所有配置均无效】。

常见原生支持的语言包括：Python、Java、JavaScript、TypeScript、Go、C++、Rust、PHP、Ruby、Shell、SQL、HTML、CSS、Vue、React JSX。列表之外的语言（如 Fortran、COBOL、VHDL）需切换到 CodeGeeX4-ALL-9B 或本地部署版本才可能获得支持。

VS Code 插件中启用多语言模型权重

方法一：自动匹配（推荐新手）
在 CodeGeeX 设置页找到「Model Selection」，选择「Auto-select by file extension」，保存后重启插件。此模式下，打开 .py 文件即自动加载 Python 优化权重，打开 .java 文件触发 Java 专用解码器，完全无需手动干预。

方法二：手动指定（适合混合项目）
在编辑器右下角状态栏找到「CodeGeeX」语言标识（例如「Python」），点击后在弹出菜单中选取目标语言，确认后当前文件即绑定该语言模型路径。注意：【该设置仅对当前打开的标签页生效，关闭文件后自动重置】。

本地部署 CodeGeeX2/CodeGeeX4 时的语言模型加载

第一步：确认模型仓库中存在对应语言子目录
进入已克隆的 CodeGeeX2 项目根目录，执行 ls models/，检查是否存在 python/、java/、go/ 等子文件夹。若仅有 general/，说明当前获取的是通用版本，未包含分语言微调权重。

第二步：下载语言专用 checkpoint
访问官方 GitCode 镜像页 https://gitcode.com/gh_mirrors/co/CodeGeeX2，进入「releases」，找到 v2.1+ 版本，下载带「lang-specific」字样的压缩包（例如 codegeex2-6b-python-finetuned.zip），解压后覆盖至 models/python/ 目录。

第三步：修改配置文件触发加载
编辑 config.yaml，定位 model_path: 行，将值改为 models/python/（以 Python 为例），保存后执行 python demo/run_demo.py 启动服务。此时 API 默认仅响应 Python 请求，其他语言需通过 HTTP Header 显式声明 X-Language: java 才能路由至对应模型。

在 prompt 中强制指定语言（适用于所有部署方式）

在 VS Code 编辑器中选中代码，右键选择「CodeGeeX: Explain Code」，在弹出的输入框顶部第一行写入：

# language: Go

随后接自然语言指令，例如：

# language: Go
写一个从 slice 中删除重复字符串的函数，保持原始顺序

该标签必须独占一行且紧贴 prompt 起始位置，不允许空行或空格。不加此标签时，模型依据当前文件后缀推测语言，但对 .ts、.jsx、.vue 等复合格式易出现误判。