首页 / 资讯中心 / 正文

PaddleOCR 日志系统配置指南：从集中式 logger 到自定义日志输出

发布时间：2026/9/12 2:26:28
PaddleOCR 日志系统配置指南：从集中式 logger 到自定义日志输出 PaddleOCR 日志系统配置指南从集中式 logger 到自定义日志输出【免费下载链接】PaddleOCRTurn any PDF or image document into structured data for your AI. A powerful, lightweight OCR toolkit that bridges the gap between images/PDFs and LLMs. Supports 100 languages.项目地址: https://gitcode.com/GitHub_Trending/pa/PaddleOCRpaddleocrPython 包内置了一套基于标准库logging的集中式日志系统通过paddleocr.logger暴露唯一入口默认仅输出ERROR及以上级别的日志。本文以 docs/version3.x/logging.en.md 为主线结合仓库源码讲解默认行为、禁用自动配置的方法以及将日志重定向到文件等自定义用法帮助你精确掌控 OCR 运行时的日志输出。集中式日志系统的设计PaddleOCR 的日志配置遵循唯一 logger的设计原则整个包共享一个名为paddleocr的 logger 实例任何模块的日志都汇入该实例。你可以在源码 paddleocr/_utils/logging.py 中看到它的定义import logging from .._env import DISABLE_AUTO_LOGGING_CONFIG LOGGER_NAME paddleocr logger logging.getLogger(LOGGER_NAME) def _set_up_logger(): if DISABLE_AUTO_LOGGING_CONFIG: return formatter logging.Formatter( [%(asctime)s] %(name)s %(levelname)s: %(message)s, datefmt%Y/%m/%d %H:%M:%S ) stream_handler logging.StreamHandler() stream_handler.setFormatter(formatter) logger.addHandler(stream_handler) logger.setLevel(logging.ERROR) logger.propagate False _set_up_logger()该 logger 在包初始化时通过 paddleocr/init.py 的from ._utils.logging import logger导出并列入__all__因此你可以直接通过from paddleocr import logger访问它。无论是 CLI 入口 paddleocr/_cli.py、OCR 流水线 paddleocr/_pipelines/ocr.py还是 doc2md 转换等模块均统一使用这一实例。需要注意本文讨论的是通过 PyPI 安装的paddleocr包version 3.x的日志系统与训练脚本使用的日志系统相互独立二者配置方法互不影响。如果你是在做模型训练请查阅训练侧文档。默认日志行为日志级别默认设为ERROR只有级别为ERROR或更高如CRITICAL的消息才会输出INFO、DEBUG等低级别消息默认被过滤。输出目标配置了StreamHandler将日志写入标准错误流stderr。传播控制logger 的propagate属性被设为False日志不会向上传递到父 logger避免与上层应用如 Jupyter Notebook 或宿主应用的日志系统相互干扰。日志格式[%(asctime)s] %(name)s %(levelname)s: %(message)s时间格式为%Y/%m/%d %H:%M:%S例如[2026/09/11 18:27:53] paddleocr ERROR: ...。该格式与 PaddleOCR 2.x 基本兼容仅输出目标改为 stderr。关闭自动配置DISABLE_AUTO_LOGGING_CONFIG若希望完全禁用 PaddleOCR 对 logger 的自动配置不再自动添加 handler、不修改级别和 propagate可设置环境变量export DISABLE_AUTO_LOGGING_CONFIG1 python your_script.py或在使用时临时注入DISABLE_AUTO_LOGGING_CONFIG1 python your_script.py此时 paddleocr/_utils/logging.py 中的_set_up_logger()会直接返回logger 保持 Python 默认状态默认级别WARNING、无 handler、propagateTrue后续所有配置都由你自行完成。细节提示源码 paddleocr/_env.py 中实际读取的环境变量名是PADDLEOCR_DISABLE_AUTO_LOGGING_CONFIG判断逻辑为os.getenv(..., 0) 1。文档中写作DISABLE_AUTO_LOGGING_CONFIG是简化表述若要严格生效请使用带PADDLEOCR_前缀的完整变量名。自定义日志输出写入文件等场景在默认配置基础上你可以继续向logger添加 handler实现将日志同时写入文件等需求。官方文档给出的写文件示例import logging from paddleocr import logger # 将日志写入文件 paddleocr.log fh logging.FileHandler(paddleocr.log) logger.addHandler(fh)更精细的定制例如为文件 handler 单独设置格式和级别并保留控制台输出可以这样写import logging from paddleocr import logger # 文件 handlerINFO 及以上级别带完整格式 fh logging.FileHandler(paddleocr.log, encodingutf-8) fh.setLevel(logging.INFO) fmt logging.Formatter( [%(asctime)s] %(name)s %(levelname)s: %(message)s, datefmt%Y/%m/%d %H:%M:%S, ) fh.setFormatter(fmt) logger.addHandler(fh) # 临时在控制台看更详细的输出将级别降到 INFO logger.setLevel(logging.INFO)需要注意两点addHandler是追加式的默认的StreamHandler不会被移除文件 handler 是叠加在其上的。如果只想保留文件输出而不要控制台输出请先调用logger.handlers.clear()再添加自己的 handler。自定义 handler 遵循标准库logging的机制可以任意扩展为RotatingFileHandler、TimedRotatingFileHandler、logging.handlers.SysLogHandler或自定义 handler 类如需更复杂的过滤与分发可直接查阅 Pythonlogging标准库文档。对依赖库日志的影响边界需要明确一个边界以上所有配置只作用于paddleocr自身的 logger。PaddleOCR 依赖的其他库如 PaddleX见 docs/version3.x/paddleocr_and_paddlex.en.md拥有各自独立的日志系统对paddleocr.logger的配置不会影响这些库的日志输出。因此若你观察到 PaddleX 等依赖库的日志不受控应在其对应文档中寻找独立的日志配置方式而不是修改paddleocr.logger。完整示例写入文件并保留控制台将上述要点组合成一个完整示例import logging from paddleocr import logger # 1. 保留默认控制台stderr输出 # 2. 新增文件输出级别为 INFO fh logging.FileHandler(paddleocr.log, encodingutf-8) fh.setLevel(logging.INFO) fmt logging.Formatter( [%(asctime)s] %(name)s %(levelname)s: %(message)s, datefmt%Y/%m/%d %H:%M:%S, ) fh.setFormatter(fmt) logger.addHandler(fh) # 3. 若希望在控制台也能看到 INFO 级别日志 # logger.setLevel(logging.INFO)运行后paddleocr.log将按你的格式记录日志而控制台默认仍只显示ERROR及以上级别的信息。结合 paddleocr/_cli.py 中 CLI 在main()里会把 logger 级别临时提升到INFO的行为你可以通过上面的方式在 Python 脚本中自行控制详细程度两者互不冲突。【免费下载链接】PaddleOCRTurn any PDF or image document into structured data for your AI. A powerful, lightweight OCR toolkit that bridges the gap between images/PDFs and LLMs. Supports 100 languages.项目地址: https://gitcode.com/GitHub_Trending/pa/PaddleOCR创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

关于本文作者

来自尧图内容编辑团队

尧图内容编辑团队 内容团队

尧图内容编辑团队

本文由尧图网络内容编辑团队执笔。团队由资深项目经理、前端工程师与设计师组成，所有内容均来自亲手交付的真实项目，先讲清问题、再给出可落地的解法。尧图深耕北京网站建设十年，服务过京华建材集团、智造科技等各行业客户，把一线经验沉淀为可复用的行业观察。

  • 十年建站经验，覆盖建材、制造、服务、文创等
  • 项目经理把关选题与事实准确性
  • 工程师与设计师联合撰写专业细节
  • 统一编辑规范，保证文风与排版一致
  • 每月复盘转化数据，迭代选题方向

延伸阅读

相关资讯与近期热门内容

相关新闻

电子元器件目标检测实战：YOLO与大模型融合方案
2026/9/12 2:26:28

电子元器件目标检测实战：YOLO与大模型融合方案

C++模板进阶：从编译期原理到特化、SFINAE与变参应用
2026/9/12 2:24:28

C++模板进阶：从编译期原理到特化、SFINAE与变参应用

基于插件化与Scriban模板引擎的HTTP协议中心设计实践
2026/9/12 2:24:28

基于插件化与Scriban模板引擎的HTTP协议中心设计实践

最新新闻

Python手势识别实战：MediaPipe+OpenCV实现0-9工业级手势系统
2026/9/12 9:08:46

Python手势识别实战：MediaPipe+OpenCV实现0-9工业级手势系统

CMSIS-5不是库，是嵌入式系统的宪法级接口规范
2026/9/12 9:08:45

CMSIS-5不是库，是嵌入式系统的宪法级接口规范

前端Excel导出实战：xlsx+FileSaver技术方案详解
2026/9/12 9:08:45

前端Excel导出实战：xlsx+FileSaver技术方案详解

Data Engineering Zoomcamp：将 Bruin 数据管道部署到 Bruin Cloud 的完整指南
2026/9/12 9:08:45

Data Engineering Zoomcamp：将 Bruin 数据管道部署到 Bruin Cloud 的完整指南

OpenClaw 接入 NovitaAI：基于 OpenAI 兼容 API 的官方 Provider 插件完整指南
2026/9/12 9:08:45

OpenClaw 接入 NovitaAI：基于 OpenAI 兼容 API 的官方 Provider 插件完整指南

35岁嵌入式工程师的破局之道：技术护城河与转型路径
2026/9/12 9:06:45

35岁嵌入式工程师的破局之道：技术护城河与转型路径

日新闻

OmniRoute 代码库架构指南：从模块地图到请求管线的源码级解读
2026/9/12 0:01:55

OmniRoute 代码库架构指南：从模块地图到请求管线的源码级解读

Simulink同步发电机短路仿真建模与实践
2026/9/12 0:01:55

Simulink同步发电机短路仿真建模与实践

SpacetimeDB C++ 模块库实战：用 C++20 在数据库内构建 WebAssembly 模块
2026/9/12 0:01:55

SpacetimeDB C++ 模块库实战：用 C++20 在数据库内构建 WebAssembly 模块

周新闻

超人会飞不算本事：系统稳定依赖清晰规则与边界设计
2026/9/11 22:12:39

超人会飞不算本事：系统稳定依赖清晰规则与边界设计

超人VS蜘蛛侠：拆解超级IP的影响力与传播方法论
2026/9/9 16:51:13

超人VS蜘蛛侠：拆解超级IP的影响力与传播方法论

基于CNN的调制信号识别：MATLAB实现时频图分类实战
2026/9/11 6:29:13

基于CNN的调制信号识别：MATLAB实现时频图分类实战

月新闻

USB Type-C PCB布局分区设计：电源、高速信号与PD协议全攻略
2026/9/11 20:02:33

USB Type-C PCB布局分区设计：电源、高速信号与PD协议全攻略

系统编程学习原型如何补齐稳定性边界
2026/9/12 4:12:51

系统编程学习原型如何补齐稳定性边界

雨花区哪家财务公司代理记账比较好？
2026/9/12 4:13:17

雨花区哪家财务公司代理记账比较好？

深度阅读推荐

建站决策前值得细读的三篇

网站改版的5个关键决策
2024-08-12

网站改版的5个关键决策

什么时候该改版、改到什么程度、如何避免流量掉光，京华建材集团改版复盘给出答案。

获取专属建站方案

看完文章，把您的行业与预算告诉我们，免费获取一份量身定制的官网建设方案与报价。

立即免费咨询