需要说明的是，Fitten Code 并不具备一键全局自动翻译的功能，每次翻译都必须由用户手动触发。操作流程需要循序渐进：首先要明确文档的类型及其所在位置，再分步骤执行。对于纯 Markdown 文件，需要打开文件后右键选中段落进行翻译；代码注释则需将光标定位到相应位置，使用快捷键调用，且指令必须写得足够严谨；批量处理主要依赖多光标或外部脚本进行预处理，但无论采用哪种方式，最终都需要人工检查格式是否正确。
有朋友提问：“能否将整个代码库中的英文文档（例如 README.md、注释块、API 文档字符串）一次性批量转换为中文？”答案是——Fitten Code 本身并未提供“全局扫描→自动翻译文档”这类一键式开关功能。你只能依靠手动触发，配合精准的指令组合来完成这项翻译任务。
确认文档类型与位置
首先需要明确你要翻译的文档类型：是纯 Markdown 文件（如 README.md），还是代码中内嵌的字符串（如 Python 的 docstring 或 JS 注释），亦或是混合型文档（例如 TypeScript 中的 JSDoc 混搭 Markdown 段落）。不同类型的文档对应不同的操作路径——Fitten Code 对纯文本文件的支持较为有限，必须打开文件并将光标定位到具体段落才能触发翻译，它无法对未打开的文件进行批量处理。
先打开 VS Code，确保左侧资源管理器中能看到目标文档，然后双击将其打开。
翻译单个 Markdown 文档段落
第一种方式：鼠标右键。
用鼠标拖选一段英文说明文字，例如 README.md 中的 “Installation” 小节，然后右键 → 选择 Fitten Code – 编辑代码（注意不是“开始聊天”，也不是“重构所选代码”）。
在弹出的对话框里输入明确的指令，举例来说：
“将以上英文内容翻译为简体中文，保持原有 Markdown 格式（标题、列表、代码块标记均不改动），术语统一，不添加解释性文字。”
点击确认后，等待结果生成。生成的内容会以可编辑状态插入原文下方，你需要手动替换原段落。
翻译代码文件中的英文注释
第一步：打开含有英文注释的源文件，比如 src/utils.ts。
第二步：将光标放在某段英文注释的开头，然后按 Ctrl+Alt+E 快捷键。
第三步：输入指令时务必带上上下文约束，例如：
“这是 TypeScript 文件中的 JSDoc 注释，请将以下内容翻译为中文，保留 @param/@returns 等标签格式，参数名和返回值类型名称不翻译，仅译自然语言描述部分。”
第四步：确认生成结果后，检查是否出现了类型名（比如 string、Promise
这里需注意：Fitten Code 不会自动识别注释边界，你选中的范围必须严格包含完整的注释块。如果遗漏了 /** 或 */，会导致语法错误。
批量处理多个文档的实操路径
第一种方法：利用 VS Code 的多光标功能，配合重复触发。
将待处理的文档全部打开 → 按 Ctrl+P，输入 `>Multi-Cursor: Add Selection to Find Match` → 输入关键词，比如 “## Usage”，定位各文件中同类章节 → 按 Ctrl+Shift+L 激活多光标 → 在每个光标处按 Ctrl+Alt+E → 统一输入相同的翻译指令 → 逐个确认生成结果。
第二种方法：导出→外部工具预处理→再导入。
将所有 .md 文件复制到一个临时文件夹 → 用 Python 脚本读取每份文件，按段落切分 → 调用 Fitten Code 的 API（需开通企业版权限）或本地大模型接口进行批处理 → 保存回原路径 → 再在 VS Code 里逐个打开，检查格式兼容性。
这一步无论如何都无法跳过人工校验，因为 Fitten Code 在处理 Markdown 表格、缩进引用块等特殊结构时，很容易丢失排版。