技术文档与普通文章最大的区别，是正文里混着大量不能翻译的内容：代码块、命令、函数名、配置项、文件路径、报错信息。把这些一起丢进翻译框，往往会得到一段读不通、复制也不能用的译文。下面是一套可以直接照着执行的流程。
一、先分清“要翻”与“不能翻”
动手前先给文档做一次标记。自然语言的说明、注意事项、参数解释需要翻译；代码、命令、变量名、接口地址、版本号、文件名保持原样。判断标准很简单：这段内容复制到编辑器里能不能直接运行，能运行的就不要翻。
- 代码块与命令行整段保留，包括缩进和换行
- 函数名、参数名、配置键名保持英文原样
- 注释可以翻译，但要与代码分开处理
- 报错信息建议保留原文，另起一行给解释
二、用占位符保护代码片段
如果工具支持占位符或“不翻译”标记，先把代码片段替换成统一格式的占位符，例如 [[CODE1]]、[[CODE2]]，翻完再按编号回填。这样能避免模型把变量名当成普通单词拆开，也能防止代码里的空格、引号被改写。
没有占位符功能时，可以先把代码块剪切到单独文件，正文翻完再粘回。操作麻烦一些，但比事后逐行核对代码有没有被改动要省时间。回填后建议用编辑器的差异对比功能过一遍，确认只改了文字部分。
三、术语与语气要统一
技术文档里同一个概念经常出现多种叫法，例如 endpoint 可能被译成“端点”“接口地址”“终结点”。开始翻译前先确定一批核心术语，导入术语库或写成对照表，后续所有段落都按同一译法处理。
语气同样需要统一。面向开发者的文档通常用简洁的陈述句和祈使句，避免“您可以尝试着……”这类客套表达。译文里统一用“调用”“返回”“传入”等动词，读起来会更像一份可执行的手册。
四、译后检查清单
技术文档的校对重点不在文采，而在可执行性。建议按下面的顺序检查，发现问题就地修改，不要留到发布前。
- 代码块能否直接复制运行，缩进是否完整
- 命令中的参数、路径、端口号是否被翻译
- 同一术语在全文中是否保持一致
- 链接、锚点与图片引用是否仍然有效
- 中英文混排时是否有多余空格或缺失标点
最后提醒一点：涉及许可证、安全警告与数据删除操作的段落，不要只依赖机器译文。这类内容一旦理解偏差，代价远高于多花十分钟人工确认。
代码块、命令和路径属于“不可翻译内容”，优先用占位符保护，再处理自然语言部分。