如何在Fitten Code中设置自动翻译代码库英文文档

需要说明的是，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 表格、缩进引用块等特殊结构时，很容易丢失排版。

你是一名 AI 行业编辑，请围绕下面这条热点输出一份资讯解读：
热点：如何在Fitten Code中设置自动翻译代码库英文文档要求：
1. 先用一句话解释这条热点在讲什么
2. 再总结它为什么重要
3. 说明会影响哪些 AI 产品或内容方向
4. 最后给出 3 个适合资讯站使用的标题