MinerU 系列教程 第二十六课：设计模式在 MinerU 中的应用

MinerU 系列教程 第二十六篇

本篇教程作为模块九：源码篇 - 设计模式与核心算法的第一课，将深入剖析 MinerU 源码中实际运用的六种经典设计模式。不同于教科书式的抽象讲解，我们将直接阅读 MinerU v3.0.9 的真实代码，理解每种模式在文档智能解析系统中的具体作用和实现细节。

学习目标

完成本课学习后，你将能够：

• 理解 MinerU 中三种 Singleton 实现的差异及其线程安全机制
• 分析atom_model_init()工厂函数族的分派逻辑
• 掌握策略模式在多后端、多引擎场景下的应用方式
• 理解 DataReader/DataWriter 适配器体系如何统一多存储后端
• 对比doc_analyze()在 VLM、Hybrid、Pipeline 三套后端中的模板方法实现
• 分析LiveTaskStatusRenderer的观察者模式实时渲染机制

一、单例模式（Singleton）：模型实例的全局管理

在文档解析系统中，深度学习模型的加载开销极大——一个布局检测模型可能占用数百 MB 显存，VLM 推理引擎更是需要数 GB。如果每次解析都重新加载模型，性能将无法接受。MinerU 通过单例模式确保每个模型实例