CodeGeeX“解释代码”功能可一键生成中文注释与逻辑说明:启用插件并登录后,选中代码按Alt+T触发explanation模板,需在设置中将解释语言设为zh-CN,再点击“Insert as Comment”插入Markdown格式注释。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

接手一个陌生的代码仓库时,逐行阅读源码耗时费力,用 CodeGeeX 的“解释代码”功能可一键生成中文注释与逻辑说明,3秒内理解关键函数作用与数据流向。
确认插件已启用并登录账号
打开 VSCode → 左侧扩展图标(或 Ctrl+Shift+X)→ 搜索 CodeGeeX → 确保状态为「已启用」;右下角出现火箭图标后,点击它 → 选择「Login」完成账号登录。未登录状态下提示模式将不可用,【解释功能完全失效】。
若右下角无图标,重启 VSCode 后仍不显示,按 Ctrl+Shift+P 打开命令面板 → 输入「CodeGeeX: Toggle Sidebar」→ 回车强制唤出侧边栏。
用提示模式触发代码解释
选中你要理解的一段函数、类或关键逻辑块(建议不超过 50 行,过长会导致解释失焦)→ 按下 Alt+T(macOS 为 Option+T)激活提示模式 → 弹出模板列表 → 点击「explanation」模板(官方内置,无需额外配置)。
CodeGeeX 会立即在右侧侧边栏生成结构化解释:包含函数目的、参数含义、返回值说明、每行代码的中文逐行解读,以及潜在风险提示(如空指针、边界条件)。这一步不需要手动输入任何指令,选中+快捷键即可触发。
调整解释语言为中文(关键步骤)
默认解释语言可能为英文,需手动切换:
① 打开 VSCode 设置(Ctrl+,)→ 在搜索框输入「codegeex explanation language」→ 找到「CodeGeeX › Explanation: Language Preference」选项 → 点击下拉菜单 → 选择「zh-CN」;
② 关闭设置页,重新执行 Alt+T → 解释结果即以完整中文呈现,含专业术语本地化(如「context manager」译为「上下文管理器」而非直译);
若跳过此步,生成的解释将全部为英文,且后续所有解释均沿用该语言设置,无法单次覆盖。
将解释结果插入代码注释
右侧侧边栏中点击「Insert as Comment」按钮 → CodeGeeX 自动在所选代码上方插入多行 Markdown 格式注释块,含标题、摘要、逐行说明;
插入后可直接保存文件,下次打开时注释仍保留——这相当于为项目自动构建了一份可执行的文档快照;
注意:该操作不会修改原代码逻辑,仅添加注释,【不可逆操作仅发生在你手动删除这些注释时】。


















