MinerU PDF转Markdown的macOS安装避坑指南3条命令搞定arm64依赖报错【免费下载链接】MinerUA high-quality tool for convert PDF to Markdown and JSON.一站式开源高质量数据提取工具将PDF转换成Markdown和JSON格式。项目地址: https://gitcode.com/OpenDataLab/MinerUMinerU 是一款把 PDF 转成 Markdown 和 JSON 的开源文档解析工具。在 Apple Silicon 的 Mac 上安装时常遇到sgl-kernel无可用轮子的报错。这篇给你一条完整的 macOS 安装与排错路线。 先说结论别纠结报错直接装 core 版本pip install mineru[core]。它打包了 vlm、pipeline、gradio 三个功能集日常 PDF 转 Markdown、JSON 的场景全都能覆盖同时绕开了 arm64 缺预编译包的那批依赖。macOS 14.0 以上的 Mac 用这套组合最稳。方案选型core、Docker、源码三条路怎么选方案适合谁优点局限pip install mineru[core]日常 Mac 用户一条命令装完体积可控核心转换能力完整不带 vllm 等服务端加速扩展Docker 容器想跑全量功能、有运维经验的人功能完整、环境隔离官方文档建议 macOS 用户优先用本地 pip 安装资源占用偏高源码编译需要改代码、定制依赖的人完全可控可针对个别依赖打补丁技术门槛高编译和依赖坑多⚠️ 坑的现场sgl-kernel 为什么在 arm64 上装不上如果你之前直接装过完整包多半会看到这样的报错ERROR: Could not find a version that satisfies the requirement sgl-kernelNo matching distribution found for sgl-kernel (from versions: none)根因一句话sgl-kernel 是带 C 编译件的底层依赖上游还没给macosx_15_0_arm64这个平台出预编译包pip 在 Apple Silicon 上找不到可安装的二进制整条依赖链就跟着失败。不是你网络差也不是 pip 版本旧升级 pip 解决不了它。安装实操在 macOS 上装 mineru[core]先确认 Python 版本MinerU 目前支持 3.10–3.13超出范围建议先处理python3 --version建一个专用虚拟环境并激活避免依赖污染系统 Pythonpython3 -m venv mineru_env source mineru_env/bin/activate升级一下 pip旧版本对新 wheel 索引支持不全再装 core 版本。注意mineru[core]必须加引号否则 shell 会把方括号当通配符解析pip install -U pip pip install mineru[core]用 uv 的同学一行替代即可uv pip install mineru[core]效果相同。✅ 验证与排错装完怎么确认没白装跑一条命令验证安装python -c import mineru; print(mineru.__version__)能打印出版本号就齐活了。几个常见情况看到ModuleNotFoundError: No module named mineru→ 虚拟环境没激活先执行source mineru_env/bin/activate再重试。再次出现sgl-kernel相关报错 → 说明你装的是mineru[all]之类的完整功能集改回mineru[core]重新安装。首次运行长时间停在下拉里 → 这是 MinerU 在自动下载模型权重属于正常现象也可以提前用mineru-models-download预取。怀疑依赖冲突时跑python -m pip check缺什么包它会直接点名。写在最后几个高频问题问mineru[core] 会少功能吗日常场景不缺PDF、DOCX、PPTX、XLSX 转 Markdown 和 JSON、Gradio WebUI 都在缺的主要是 vllm 这类只在 Linux 上部署的加速服务。真有这需求放到 Linux 机器上装完整版更合适。问模型权重下载太慢怎么办首次运行才拉模型之后都走本地缓存。可以先用mineru-models-download预取或给 pip 配国内镜像源加速装包。更多环境要求与安装选项可以看项目里的docs/zh/quick_start/目录里面有完整的软硬件支持说明。【免费下载链接】MinerUA high-quality tool for convert PDF to Markdown and JSON.一站式开源高质量数据提取工具将PDF转换成Markdown和JSON格式。项目地址: https://gitcode.com/OpenDataLab/MinerU创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考