如何把英文论文快速翻成双语PDF：BabelDOC PDF翻译3步上手完整指南
【免费下载链接】BabelDOCYet Another Document Translator项目地址: https://gitcode.com/GitHub_Trending/ba/BabelDOC
BabelDOC 是一个开源的 PDF 翻译工具：给它一个英文 PDF，它会返回保持原版式的中译版和一份双语对照 PDF，公式与表格排版不会乱。
场景：手头的英文论文
拿到一篇十几页的英文论文，粘进在线翻译工具，排版会碎、公式会变乱码。BabelDOC 就是针对这类问题做的：它先解析 PDF、识别版式，再逐段调用大模型翻译，最后把译文写回原排版结构，默认同时输出中译版和双语对照版两种 PDF。
环境准备与首次运行 🚀
建议 Python 3.12+，用 uv（一个快速 Python 包管理器）一行装好：
uv tool install --python 3.12 BabelDOC也可以从源码安装：
git clone https://gitcode.com/GitHub_Trending/ba/BabelDOC cd BabelDOC && uv run babeldoc --help一条最小翻译命令（需要 OpenAI 兼容接口的 API key）：
babeldoc --files 论文.pdf --openai --openai-model "gpt-4o-mini" --openai-api-key "你的key"三条可照抄的翻译命令 📄
整篇翻译
不加页码参数即默认翻译全文，源语言默认en、目标语言默认zh：
babeldoc --files 论文.pdf --openai --openai-model "gpt-4o-mini" --openai-api-key "你的key"指定页码翻译命令
只翻译指定页时加上--pages：
babeldoc --files 论文.pdf --pages "1,3,5" --lang-in en --lang-out zh--pages也支持区间写法，如1-10、3-（第 3 页到结尾）。
批量处理多个文件
重复--files参数即可一次处理多份 PDF：
babeldoc --files 文档1.pdf --files 文档2.pdf --files 文档3.pdf高频参数速查表
| 参数 | 作用 | 示例值 |
|---|---|---|
--files | 输入 PDF，可重复使用 | 论文.pdf |
--pages | 只翻译指定页，留空为全文 | "1,3,5"、"1-10" |
--lang-in/--lang-out | 源语言 / 目标语言 | en/zh |
--openai-model | 翻译用的 LLM 模型（OpenAI 兼容） | gpt-4o-mini |
--qps | 翻译服务限流，默认 4 | 8 |
--no-dual/--no-mono | 关闭双语版 / 单语版输出 | --no-mono |
--glossary-files | 术语表 CSV，保证专有名词译法一致 | terms.csv |
--max-pages-per-part | 大文档分块翻译后自动合并 | 50 |
--watermark-output-mode | 译版 PDF 水印模式 | no_watermark |
进阶技巧与避坑
- 表格文本是实验功能：加
--translate-table-text开启表格翻译，建议先用小文档测试。 - 大文档分块：页数多的文件用
--max-pages-per-part 50分块翻译再自动合并，比整篇一次性翻更稳。 - 兼容性问题：若输出的 PDF 在某些阅读器打不开，先试
--enhance-compatibility，它一次性开启一组兼容增强选项。 - 语言范围：项目目前主要聚焦中英互译，其他语言对测试较少，使用前可查 docs/supported_languages.md；确定不是扫描版 PDF 时加
--skip-scanned-detection可加快处理。
原理与架构速览 🧠
核心流程是“解析 → 识别 → 翻译 → 排版”，模块分工如下：
- babeldoc/format/pdf/：PDF 解析与重生成，内部是一条中间层（IL，文档的结构化描述）流水线，依次做段落识别、样式与公式处理、翻译、排版。
- babeldoc/docvision/：文档布局分析，跑本地模型识别页面中段落、公式、表格、图片的位置。
- babeldoc/translator/：翻译引擎，调用 OpenAI 兼容的大模型接口，带翻译缓存避免重复调用。
- 每个阶段的实现细节在 docs/ImplementationDetails/ 目录有单独的文章。
小结
BabelDOC 适合需要频繁阅读英文论文、希望拿到一份不乱版式的双语对照 PDF 的人：装好依赖后照抄上面的最小命令，就能拿到第一个翻译结果。更多 IL 格式样例见 examples/，完整参数用babeldoc --help查看全部。
【免费下载链接】BabelDOCYet Another Document Translator项目地址: https://gitcode.com/GitHub_Trending/ba/BabelDOC
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
