PDFMathTranslate 完整教程：免费保留排版的 PDF 翻译，本地部署只需 5 分钟

2026/10/27 18:44:19

PDFMathTranslate 完整教程：免费保留排版的 PDF 翻译，本地部署只需 5 分钟

【免费下载链接】PDFMathTranslatePDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/Docker项目地址: https://gitcode.com/Byaidu/PDFMathTranslate

PDFMathTranslate 是一款完整保留排版的 PDF 全文翻译开源工具。数学公式、图表和注释都会原样保留。它适合不想把论文上传云端的科研人员和学生。解决的核心痛点就两个：格式被翻译工具打乱、敏感数据外泄。

一、快速上手：PDFMathTranslate 本地部署三步走 🚀

环境要求

开始前，先确认本地环境满足三项条件：

Python 版本在 3.10 到 3.12 之间，执行python --version检查
可用内存至少 8GB，推荐 16GB 以上
磁盘预留 10GB 以上空间，用来存放本地模型文件

安装依赖

先克隆源码，再装依赖，一共三条命令：

git clone https://gitcode.com/Byaidu/PDFMathTranslate cd PDFMathTranslate pip install -r requirements.txt

首次启动

运行python pdf2zh/gui.py，程序会打开基于浏览器的图形界面。如果浏览器没有自动弹出，手动访问http://localhost:7860/。看到文件上传区域，说明本地部署完成。

二、核心能力：PDF 公式翻译与排版保留

1. 排版保留是第一位。论文翻译最头疼的是翻译完还要重新排版。它通过布局分析，让公式、图表、目录和注释留在原位。你只关心内容，不用碰格式。

2. 翻译服务可选，本地模型在内。支持 Google、DeepL、OpenAI 等云服务，也支持 Ollama 这类本地服务。接上 Ollama，整个流程可以完全离线。

3. 三种使用形态。命令行、GUI、Docker 都有。批处理、可视化操作、容器化部署，按场景选。

本地化和云端翻译的差异，一张表看清：

对比项	本地化翻译（Ollama）	云端翻译服务
数据安全	高，文档不出本机	数据上传第三方服务器
网络依赖	完全离线	必须联网
响应速度	不受网络影响	依赖带宽状况
格式保留	完整保留复杂排版	可能丢失格式信息

适合这几类人：

科研人员：未发表成果、专利草稿在本地处理，数据不出门
学生：批量翻译文献综述，全程不依赖外网
学术出版：快速产出双语对照版本

三、实操演示：用 GUI 翻译一篇英文论文

下面用本地模型，把一篇英文论文译成中文。

把 PDF 拖进 "Drop File Here" 区域
在 "Service" 下拉菜单选择 ollama 本地服务
设置目标语言为中文，选定翻译页码范围
点击橙色 "Translate" 按钮开始
翻译完成后，点击 "Download Translation" 下载结果

翻译前的英文原文：

翻译后的中文版落在原文位置，排版结构没有变化：

习惯命令行的话，一条命令也能跑：

pdf2zh document.pdf -s ollama:gemma2

-s参数同时指定服务名和模型名。想精细调整，就在配置文件的translation_config里改：service设为ollama，api_base填本地地址，temperature设 0.2（低温让术语更一致），max_tokens设 8192，timeout设 300（本地模型推理慢，多给些时间）。

四、常见坑与解决：PDFMathTranslate 本地部署避坑 ⚠️

坑 1：本地模型加载失败

现象：模型加载时报错，或进程被系统直接杀掉
原因：模型文件没下载完整，或显存、内存撑不住大模型
解法：先校验模型文件完整性；确认内存达标；仍失败就把模型从llama3:70b降到llama3:13b这类小尺寸

坑 2：翻译中途崩溃或连接失败 🔧

现象：一次翻译页数很多时程序崩溃；连本地服务报 404
原因：单次处理页数过多导致内存吃紧；api_base缺少/v1后缀
解法：减少单次翻译的页面数量；把配置里的timeout调大到 300；关掉其他占内存的应用；api_base改成http://localhost:11434/v1