必须使用 codegeex 的「翻译模式」实现精准注释翻译：先登录账号确保状态为“ready”，再通过右键菜单、侧边栏或自然语言指令三种方式处理，严格保留代码结构与技术术语。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 VSCode 中把中文注释转成英文、或把英文注释还原为中文，且保持代码结构不变、不误翻变量名和语法，必须用 CodeGeeX 的「翻译模式」配合精准触发方式——它不依赖通用翻译 API，而是基于代码语义理解做上下文感知的注释重写，比纯文本插件更可靠。
确认 CodeGeeX 已安装并登录账号
打开 VSCode 扩展面板，搜索「CodeGeeX」，安装官方版本（作者：tsinghua-nlp），安装后重启编辑器。
启动后右下角出现蓝色 CodeGeeX 图标，点击登录按钮，使用 GitHub 或邮箱完成身份验证；【未登录状态下无法调用翻译模型，所有翻译操作将静默失败】。
检查状态栏右侧是否显示“Ready”，若显示“Offline”或“Not signed in”，翻译功能不可用。
用右键菜单精准翻译单行/多行注释
方法一：适用于快速处理 1～3 行标准注释
在编辑器中用鼠标选中整段注释内容（包括 //、/* */ 或 /** */ 符号本身），确保不跨选代码行也不遗漏注释边界符号。
右键 → CodeGeeX Tool → Translation mode，此时选中的注释自动载入 Input Code 区域。
在 Translate Into 下拉菜单中选择目标语言：英文注释选 en，中文注释选 zh；CodeGeeX 会自动识别源语言，无需手动指定。
点击 Translate，等待右下角图标停止旋转；输出区显示结果后，点击 Insert 按钮，新注释将原位替换旧注释——变量名、缩写、API 名称等技术术语会被保留，仅自然语言部分被重写。
用侧边栏处理含嵌套逻辑的混合注释块
当注释里夹杂代码片段、Markdown 格式或换行混乱时，右键方式容易截断，必须改用侧边栏结构化操作。
第一步：点击右侧边栏 CodeGeeX 图标，打开面板 → 切换到「Translation」标签页。
第二步：将完整注释块（含前后空行、缩进、特殊符号）复制粘贴至 Input Code 文本框；不要拖拽文件，文件拖入会触发全文件翻译而非注释专项处理。
第三步：在 Translate Into 中选定目标语言，再手动勾选「Preserve code identifiers」选项——这能强制模型跳过所有驼峰命名、下划线变量、函数调用等非自然语言成分。
第四步：点击 Translate，Output Code 中若出现类似 // 初始化配置对象 → // Initialize config object 这样的干净映射，说明识别成功；若输出含代码语法错误，立即关闭面板，返回检查是否误粘贴了实际代码而非纯注释。
用自然语言指令控制翻译风格与术语一致性
方法三：解决团队术语表冲突、规避直译歧义
右键任意位置 → Ask CodeGeeX，输入明确指令，例如：“把以下注释译为英文，术语‘用户态’统一用‘user mode’，‘内核态’用‘kernel mode’，不翻译括号内的英文缩写如 PID、UID”。
将待翻译的中文注释紧接指令下方粘贴，例如：
// 用户态进程需通过系统调用进入内核态（PID: process ID, UID: user ID）
按回车提交，侧边栏返回结果会严格遵循你定义的术语规则，且自动保留 PID/UID 原样不动。
注意：指令中必须包含“术语”“统一用”“不翻译”等强约束词，否则模型默认自由发挥，可能将 UID 翻成 “User Identification Number”。
验证翻译结果是否污染代码结构
插入翻译结果后，立刻检查三处：光标所在行是否仍以 // 或 /* 开头；注释后是否有意外空行或缩进偏移；原注释末尾的分号、逗号、括号是否被误删。
若发现 /* */ 注释被拆成两行或 /** */ 文档注释丢失 @param 标签，说明模型过度解析了格式——此时应退回侧边栏，清除 Input Code，重新粘贴并勾选「Strict comment syntax preservation」。
这一步操作起来很简单，直接把文件拖进去就行。
