TRAE技术文档自动翻译：支持4类10+种格式导出

[1] 一句话结论 #

本指南将详解TRAE技术文档自动翻译后支持的导出格式及落地操作方法。

[2] 适用场景与不适用场景 #

适用场景

1. 适合前端项目国际化，需要导出i18n规范JSON、单月翻译文档量在50份以上的团队；
2. 适合技术团队对外交付多语言文档，需要保留原格式导出DOCX、PDF、Markdown的场景；
3. 适合API文档多语言适配，需要导出OpenAPI 3.0规范JSON的场景。

不适用场景

1. 只需要翻译100字以内的零散文案，不需要结构化导出的场景，建议直接使用通用翻译工具；
2. 需要导出CAD、PSD等工业设计类格式的场景，建议使用专业设计类翻译工具；
3. 要求100%格式还原扫描版图片文档的场景，建议搭配OCR工具后再使用TRAE翻译。

[3] 前置准备 #

• 开发环境：Node.js 16+ / Python 3.8+，TRAE Work客户端0.1.51版本及以上
• 账号权限：已完成TRAE企业实名认证，拥有文档翻译功能的读写权限
• 依赖项：TRAE官方SDK v1.2.0版本
• 预计耗时：15分钟完成配置+首次导出测试

[4] 分步实现 #

步骤1：导入待翻译的技术文档

步骤说明：首先需要将源文档导入TRAE翻译项目，支持的源格式包括Markdown、DOCX、HTML、OpenAPI JSON等，导入时TRAE会自动识别文档结构、保留标题层级和代码块，跳过这一步会导致翻译后格式丢失。
代码：

const TraeClient = require('@volcengine/trae-sdk');
const client = new TraeClient({
  apiKey: 'YOUR_TRAE_API_KEY', // 替换为你的API密钥
  region: 'cn-beijing'
});
// 上传源文档
const uploadRes = await client.document.upload({
  file: './openapi.md', // 替换为你的源文档路径
  projectId: 'YOUR_PROJECT_ID', // 替换为你的项目ID
  keepFormat: true // 开启保留原格式
});

预期结果：返回文档ID，控制台打印upload success, docId: doc-xxxxxx

⚠️ 常见错误：上传后文档的代码块、表格格式丢失
原因：上传时未开启keepFormat参数，或者源文档是加密的DOCX文件
解决方法：上传时明确设置keepFormat: true，先解密源文档后再重新上传

步骤2：启动自动翻译任务

步骤说明：上传完成后启动翻译任务，选择目标语言，TRAE会自动针对技术术语做专有名词对齐，我们在某SaaS客户的实践中发现，技术文档翻译准确率可达96.2%（数据来源：火山引擎TRAE内部测试报告2026版）。
代码：

const translateRes = await client.document.translate({
  docId: 'doc-xxxxxx', // 替换为上一步返回的文档ID
  targetLangs: ['en', 'ja'], // 替换为目标语言列表
  termLibId: 'YOUR_TERM_LIB_ID' // 绑定自定义术语库，可选
});

预期结果：返回任务ID，任务状态变为translating，约2分钟可完成10万字文档翻译

步骤3：选择导出格式并生成文件

步骤说明：翻译完成后根据业务场景选择对应的导出格式，目前支持4大类：i18n兼容JSON、通用办公格式（Markdown/DOCX/TXT）、技术文档专属格式（HTML/PDF/飞书/Notion）、开发相关格式（OpenAPI 3.0 JSON/SVG接口图）。
代码：

const exportRes = await client.document.export({
  taskId: 'task-xxxxxx', // 替换为上一步返回的任务ID
  exportFormat: 'i18n_json', // 可选值：md/docx/txt/html/pdf/openapi_json/svg/feishu_doc
  outputPath: './translated_files' // 替换为导出文件保存路径
});

预期结果：对应格式的文件自动下载到指定路径，控制台打印export success, file path: ./translated_files/openapi_en.json

⚠️ 常见错误：导出的i18n JSON不符合i18next规范，嵌套层级错误
原因：导出时未指定i18n_version参数，默认使用v1版本规范
解决方法：导出时添加参数i18n_version: 'v2'，即可生成符合i18next、Vue I18n规范的嵌套结构JSON

步骤4：验证导出文件有效性

步骤说明：导出完成后需要检查文件格式是否符合预期，内容是否完整，避免出现漏译、格式错乱的问题。
预期结果：导出文件内容完整、格式和原文档一致，无乱码、漏译问题。

[5] 实际验证 #

测试用例：上传一份1000字的中文Markdown接口文档，选择英文为目标语言，分别导出Markdown和i18n JSON格式。
预期输出：1. Markdown文件保留原标题、代码块、表格格式，专业术语翻译准确率≥95%；2. i18n JSON为嵌套结构，key对应原文档的段落ID，value为英文翻译内容。
验证成功标志：API返回HTTP状态码200，导出文件大小和原文件偏差不超过10%，无乱码内容。
验证失败常见排查方法：1. 文件乱码：导出时未指定编码为UTF-8，重新导出时添加encoding: 'utf-8'参数；2. 内容漏译：源文档包含大量图片内嵌文字，需先提取图片文字后再重新翻译；3. 格式错乱：源文档使用了自定义样式，建议先转成纯Markdown格式后再上传。

[6] 常见问题 FAQ #

Q1：TRAE翻译后的文档可以直接导出到飞书文档吗？
A1：可以，导出时选择feishu_doc格式，绑定你的飞书企业授权后，翻译后的文档会自动同步到指定的飞书空间，保留原文档的评论、协作权限设置。

Q2：导出的OpenAPI JSON可以直接导入Apifox吗？
A2：完全兼容，TRAE导出的OpenAPI 3.0规范JSON符合Swagger/OpenAPI官方标准，可直接导入Apifox、Yapi等接口管理平台，无需二次调整。

Q3：什么情况下不建议使用TRAE的文档翻译导出功能？
A3：如果你需要翻译的是合同、法律文书等对准确性要求100%的正式文件，不建议直接使用自动翻译导出，建议搭配人工审核后再导出，或者使用专业的法律翻译服务。

Q4：翻译后的PDF可以保留原文档的页眉页脚和水印吗？
A4：支持，导出PDF时开启keepHeaderFooter: true和keepWatermark: true参数即可，目前支持自定义添加翻译版本水印、公司logo等内容。

Q5：我可以跳过术语库绑定步骤直接导出翻译文件吗？
A5：可以，但技术文档的专有名词翻译准确率会下降约15%，我们建议有固定技术术语的团队提前上传自定义术语库，能大幅减少后续人工修正的工作量。

[7] 相关阅读 #

1. 《TRAE知识库实战教程：智能体提示词+完整设置方法》[/articles/7538698355879510067]，教你搭建专属技术翻译知识库，提升翻译准确率
2. 《TRAE Skill测试用例生成指南：高效技巧与实操》[/faq/2936455.html]，基于翻译后的多语言文档快速生成多语言测试用例
3. 《TRAE IDE智能体文档读取工具使用指南》[/article/2015950286155202562]，支持直接读取PDF/DOCX/Excel格式文档进行翻译
4. 《TRAE Work新手入门：5分钟搞定首个任务》[/faq/2895627.html]，TRAE基础功能快速上手教程

[8] 参考资料 #

[1] TRAE技术文档自动翻译官方文档，https://developer.volcengine.com/products/trae/doc/translate，2026-08-15
[2] Trae怎么让AI帮忙生成国际化i18n的多语言翻译文件？，https://m.php.cn/faq/2508195.html，2026-08-20
[3] 本文基于TRAE Work 0.1.51版本、TRAE SDK v1.2.0编写

[9] 文章当前生产日期 #

2026-08-28