
PDFMathTranslate 打包指南把 Python 翻译工具变成 Windows 独立可执行程序【免费下载链接】PDFMathTranslate[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译支持 Google/DeepL/Ollama/OpenAI 等服务提供 CLI/GUI/MCP/Docker/Zotero项目地址: https://gitcode.com/GitHub_Trending/pd/PDFMathTranslatePDFMathTranslatepip 包名 pdf2zh是一款保留公式、图表与版式的 PDF 全文翻译工具支持 DeepL、Google、Ollama、OpenAI 等翻译服务。这篇文章带你完成一件具体的事在不安装 Python 的 Windows 电脑上得到一个能直接运行的 pdf2zh——双击就出图形界面命令行输入文档名就能翻译。先想清楚你要的独立程序是哪种形态打包有两种常见目标路线完全不同自带运行时的可移植目录一个文件夹里同时装着嵌入式 Python 和全部依赖拷到任何 Windows 机器上都能跑。这是官方 打包脚本 的产物。单文件 .exe用 PyInstaller 把代码和依赖压进一个可执行文件适合分发单个文件。项目没有现成的 spec 文件需要自己拼参数。如果你只是想让别人双击就能用选第一种就够了它不需要你具备 PyInstaller 经验失败面也小。下面两条路线都可以走建议先跑通第一条。最短路线跑一遍官方打包脚本先把项目克隆到本地git clone https://gitcode.com/GitHub_Trending/pd/PDFMathTranslate cd PDFMathTranslate脚本位于script/setup.bat目的只有一个从零搭出一个可用的运行环境。在仓库根目录执行它或双击运行它会依次完成四件事下载并解压 Python 3.12.7 嵌入式版到pdf2zh_dist目录脚本内写死了版本号给嵌入式 Python 装好 pip并升级 setuptoolspip install --upgrade pdf2zh把包及其依赖全部装进该目录运行pdf2zh -i做初始化并直接启动图形界面。成功标志很直观终端停在那之前pdf2zh_dist\python.exe已存在脚本末尾会拉起一个本地网页界面。如果你在国内网络环境下载慢脚本已内置了阿里云 PyPI 镜像和 HF 镜像地址若镜像本身失效改成默认源重试即可。进阶路线用 PyInstaller 自己拼一个 .exe这条路线的自由度更高但你要自己回答一个问题PyInstaller 扫描不到哪些模块项目里通过运行时动态加载的组件比如翻译内核相关的子模块容易漏漏了就会在双击 .exe 时报ModuleNotFoundError。自建 spec 时决定成败的关键参数只有三个其余保持默认hiddenimports显式列出扫描不到的模块至少把pdf2zh.backend、pdf2zh.translator加进去datas把pdf2zh包内非.py的模板、资源文件一并带上单文件模式下consoleTrue先保留控制台出错时能看到 traceback 再定位。拼好 spec 后执行pyinstaller pdf2zh.spec产物落在dist目录。注意spec 文件是你本地新建的不属于仓库内容不要提交回项目。具体哪些模块需要列入 hiddenimports以实际报错为准。验收清单怎么确认打包成功按顺序做三项检查全过才算数目录完整性pdf2zh_dist里应有python.exe、Scripts、Lib且Lib\site-packages下能看到pdf2zh目录。命令行可用在pdf2zh_dist下运行下面的命令目的只是验证依赖装全了pdf2zh -v预期输出一行版本信息当前发布版本见 pyproject.toml。图形界面可启动运行pdf2zh -i浏览器弹出界面、能拖入 PDF 并选择翻译服务即成功。翻译一篇完整文档耗时较长验收阶段建议用pdf2zh --pages 1 document.pdf只翻第一页确认输出 PDF 生成且公式未散版即可。常见的三个卡点界面没弹出来先回到第 2 步跑pdf2zh -v。如果报No module named site说明嵌入式 Python 的python312._pth里缺少import site这一行——这正是脚本里那步echo import site 的作用手动环境要补上它。依赖装到一半失败看报错里是下载哪个包。走镜像失败就换成默认 PyPI 源重装个别包版本锁定如pdfminer-six、pymupdf1.25.3装不上时以 pyproject.toml 里的版本约束为准。翻译调用不通多数翻译服务需要密钥或代理。代理配置方法见 PROXY_CONFIGURATION.md语言与服务的完整清单见 README 和 GUI 文档。到这里你得到的是一个可整目录拷贝、目标机器零依赖的 pdf2zh 运行环境如果你还需要单文件 .exe 或 Linux 下的同类做法下一步可以研究 PyInstaller 的 hiddenimports 排查方法或直接参考仓库文档里 Docker 方式的部署说明。【免费下载链接】PDFMathTranslate[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译支持 Google/DeepL/Ollama/OpenAI 等服务提供 CLI/GUI/MCP/Docker/Zotero项目地址: https://gitcode.com/GitHub_Trending/pd/PDFMathTranslate创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考