paddlepaddle--paddleocr/docs/version3.x/logging.md

comments

comments
true

日志

本文档主要介绍如何配置通过 PyPI 安装的 paddleocr 包的日志系统。需要注意的是，paddleocr 与训练脚本使用的是不同的日志系统，本文档不涉及训练脚本所使用的日志系统的配置方法。

PaddleOCR 构建了一个基于 Python logging 标准库 的集中式日志系统。换言之，PaddleOCR 使用唯一的日志记录器（logger），可通过 paddleocr.logger 访问和配置。

默认情况下，PaddleOCR 的日志级别设为 ERROR，这意味着仅当日志级别为 ERROR 或更高（如 CRITICAL）时，日志信息才会输出。PaddleOCR 同时为该日志记录器配置了一个 StreamHandler，将日志输出到标准错误流，并将记录器的 propagate 属性设为 False，以避免日志信息传递到其父记录器。

若希望禁止 PaddleOCR 对日志系统的自动配置行为，可将环境变量 DISABLE_AUTO_LOGGING_CONFIG 设为 1。此时，PaddleOCR 将不会对日志记录器进行任何额外配置。

如需更灵活地定制日志行为，可参考 logging 标准库的相关文档。以下是一个将日志写入文件的示例：

import logging
from paddleocr import logger

# 将日志写入文件 `paddleocr.log`
fh = logging.FileHandler("paddleocr.log")
logger.addHandler(fh)

请注意，PaddleOCR 依赖的其他库（如 PaddleX）拥有各自独立的日志系统，以上配置不会影响这些库的日志输出。