统一日志配置需在主入口调用一次dictConfig，其余模块仅用logging.getLogger(__name__)获取logger；根logger设默认级别并绑定处理器，子logger可单独配置，所有handler须设"propagate": False。
Python多模块项目中，日志分散配置会导致格式不一致、级别混乱、输出目标错乱，甚至出现重复打印。统一日志配置的关键在于：只在主入口（如 __main__.py 或启动脚本）中调用一次 logging.config.dictConfig() 或 basicConfig()，其余模块一律用 logging.getLogger(__name__) 获取 logger，不自行配置。
集中配置：用 dictConfig 定义全局日志行为
推荐使用字典方式配置，灵活支持处理器、过滤器、格式化器的组合。把配置字典放在独立文件（如 log_config.py）或直接在主模块顶部定义：
- 指定一个根 logger，设置默认级别（如
"INFO"），并绑定控制台和文件处理器 - 为不同模块名（如
"api"、"db"）单独配置子 logger，可覆盖级别或添加专用处理器（如仅记录 SQL 到sql.log） - 所有 handler 必须显式设置
"propagate": False，避免日志向上冒泡到根 logger 导致重复输出
模块内规范：只获取 logger，不配置、不初始化
每个模块（api/handler.py、db/connector.py 等）开头只需：
import logging logger = logging.getLogger(__name__)
这样获得的 logger 自动继承集中配置的格式、级别和输出目标。切勿在模块中调用 basicConfig、getLogger().setLevel 或 addHandler，否则会破坏统一性。
立即学习“Python免费学习笔记（深入）”；
按需启用调试：运行时动态调整模块级别
上线后通常只需 INFO 级别，但排查问题时可能需要临时提高某模块的日志量。可在启动时读取环境变量或命令行参数：
- 例如设置
LOG_LEVEL_DB=DEBUG，在集中配置中读取该变量，为"db"logger 单独设为 DEBUG - 或在主程序中执行
logging.getLogger("db").setLevel(logging.DEBUG)—— 这不会影响其他模块，且比改代码重启更快
避免常见陷阱
不要在包的 __init__.py 中调用 logging 配置；不要用 print() 替代日志；不要为每个函数新建 logger 实例。统一配置后，新增模块无需任何日志相关代码，只要 import logging + getLogger(__name__) 就自动接入整个日志体系。
