codegeex「解释代码」功能需登录且语言设为zh-cn才支持中文注释,否则无响应或返回英文;alt+t无反应多因未登录或插件未启用,侧边栏图标灰色表示未登录,需手动唤出并登录;解释结果为markdown块注释,非行注释,且受原代码注释嵌套影响。

CodeGeeX 的「解释代码」功能是目前 VSCode 中对新手最友好的函数逻辑理解工具,但必须完成登录 + 语言设为 zh-CN 两步,否则返回英文或直接无响应。
为什么选中代码按 Alt+T 没反应?
最常见原因是未登录或插件未启用:右下角没有火箭图标,说明插件没激活;即使图标存在,未登录也会导致 Alt+T 触发后侧边栏空白。重启 VSCode 后仍无图标,可手动执行命令 CodeGeeX: Toggle Sidebar 唤出侧边栏,再点击登录按钮。登录成功后,图标会从灰色变为蓝色。
explanation 模板生成的注释为什么全是英文?
VSCode 默认使用系统语言或插件内置 fallback,zh-CN 必须显式设置:打开设置(Ctrl+,),搜索 codegeex explanation language,在 CodeGeeX › Explanation: Language Preference 项中选择 zh-CN。这一步不可跳过——即使你已用中文提问、界面是中文,解释语言仍默认为 en-US。
解释结果插入后格式混乱或不显示?
CodeGeeX 默认插入的是 Markdown 格式注释,不是普通行注释。它会在选中代码上方生成带标题、参数表和逐行解读的 /* ... */ 块注释。如果你期望的是 // 形式,需手动调整;更关键的是,部分语言(如 C++)对块注释嵌套敏感,若原代码已有未闭合的 /*,会导致插入失败或语法高亮错乱。建议先确保目标函数周围无未配对的注释符号。
真正卡住新手的往往不是功能不会用,而是登录状态和语言设置这两个开关被忽略——它们不像快捷键那样有视觉反馈,却直接决定整个解释流程是否启动。











