Python全局日志收集的关键是主模块统一配置、各模块用logging.getLogger(__name__)获取同源logger。需在入口只初始化一次，禁用重复basicConfig，支持多环境分级输出，并规避多进程与第三方库日志冲突。
Python全局日志收集的关键，不在于每个模块重复写logging.basicConfig()，而在于统一配置、按需获取、避免冲突。核心是：只在主程序初始化一次日志系统，其他模块用logging.getLogger(__name__)获取同源logger。
一、主模块统一配置（只做一次）
在项目入口（如main.py或app.py）中完成全部日志设置，包括输出目标、格式、级别和处理器。后续模块不再调用basicConfig，否则会失效或覆盖。
推荐做法：
- 使用
logging.config.dictConfig()加载字典配置，清晰易维护 - 添加
RotatingFileHandler或TimedRotatingFileHandler实现日志轮转 - 设置
disable_existing_loggers=False，确保已有logger（如第三方库）仍可输出
二、各业务模块规范获取logger
每个模块（如db.py、api/handler.py）只需一行：
立即学习“Python免费学习笔记（深入）”；
import logging
logger = logging.getLogger(__name__)
这样做的好处：
-
__name__自动带包路径（如api.handler），便于区分来源 - 所有logger共享主模块配置的handler和level，无需重复设置
- 可通过logger名单独调整某模块日志级别（例如调试时临时提高
db模块为DEBUG）
三、支持多环境与分级输出
开发、测试、生产环境常需不同日志行为。可在主配置中按ENV变量动态切换：
- 开发环境：控制台输出 + INFO以上 + 行号文件名
- 生产环境：仅文件输出 + WARNING以上 + JSON格式（方便ELK采集）
- 可为关键模块（如支付、用户认证）单独加一个
StreamHandler实时打印到终端，不影响主日志流
四、避免常见坑
实际落地时容易踩的几个点：
- 不要在模块顶层多次调用
basicConfig()——它只生效第一次，后面无效且可能静默失败 - 不要用
logging.getLogger()无参调用——它返回root logger，破坏层级结构 - 若用
concurrent.futures或多进程，子进程需重新配置日志（因fork后handler不可跨进程复用） - 第三方库（如requests、sqlalchemy）默认用root logger，可通过
logging.getLogger("requests").setLevel(logging.WARNING)单独降噪
基本上就这些。不复杂但容易忽略细节，把初始化收口、获取方式对齐、环境策略分清，多模块日志就能稳稳跑起来。
