企业官网建设流程全解析

MinerU Python 3.10–3.13 全版本兼容指南：快速完成安装与任意版本部署

【免费下载链接】MinerUTransforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.项目地址: https://gitcode.com/GitHub_Trending/mi/MinerU

MinerU 是把 PDF 和 Office 文档转成 LLM 可直接使用的 Markdown 与 JSON 的解析工具，本文从新手角度讲清它的 Python 版本兼容问题：3.10–3.13 全部官方支持，怎么选版本、怎么一次装对。

生产环境选哪个 Python 版本

懒人结论：生产直接用 3.11，尝鲜用 3.13，只要落在 3.10–3.13 之间都能装能跑。

一条命令级路径装好 MinerU

用 Conda 建隔离环境，三步走完：

conda create -n mineru python=3.11 -y conda activate mineru pip install -U "mineru[core]"

装完即可用。mineru[core]已捆绑 VLM、pipeline 解析与 Gradio 可视界面，只要命令行能力则装基础包即可；CLI 参数细节可查docs/zh/usage/cli_tools.md。偏好容器化部署的话，docker/目录已备好现成的 Dockerfile 与 compose 配置，拉镜像直接运行。

兼容原理一句话讲清

兼容不是碰运气，靠两个机制：pyproject.toml里用requires-python = ">=3.10,<3.14"声明版本范围，范围外的 pip 会直接拒装，避免"装上了却跑不起来"的鬼影安装；各功能模块的依赖再拆成[core]、[pipeline]、[vlm]等 extras，由安装工具按实际 Python 自动解析版本。

典型写法是tomli; python_version < '3.11'这类版本条件：3.10 环境自动补装兼容包，3.11+ 自动跳过。依赖声明里散布着这种"按版本分叉"的规则，所以跨版本安装不需要手工调包。

上图是 MinerU 的分层架构：预处理、模型层、管线层、输出层与质检层。解析逻辑与 Python 版本无关，四个版本上行为完全一致，变的只是依赖的解析方式。

避坑指南：四个常见报错

• 装的时候直接报 "requires Python >=3.10,<3.14"：当前环境是 3.9 或 3.14+，切到范围内版本重装即可。
• torch、vllm 等依赖冲突：它们来自 vlm/vllm 类 extras，体量大且版本敏感。纯 CPU 机器只装mineru[core]；GPU 机器按需装对应 extras 并让解析器一次算完，别手工锁版本。
• 中文缺字、字体报错：Linux 先装 Noto CJK 字体（fonts-noto-cjk），否则中文 PDF 渲染会出乱码。
• 本地能跑、服务器跑挂：多半是两边 Python 版本不一致导致依赖解析结果不同，统一同一小版本并固定 mineru 版本号。

收尾

MinerU 的跨版本兼容本质就是一句话：范围声明清楚、依赖按版本自适应，3.10–3.13 任选一个都能放心用。

下一步动作：照上面的命令建好 3.11 环境，丢一份 PDF 跑一遍mineru，看看 Markdown 输出 🚀

【免费下载链接】MinerUTransforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.项目地址: https://gitcode.com/GitHub_Trending/mi/MinerU