统一日志配置需在主入口调用一次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，否则会破坏统一性。
一个经过完善设计有着及其强大的会员互动和独特创新的内容管理系统。主要功能模块包括：文章频道、图片频道、下载频道、动漫频道、音乐频道、影视频道、商城频道、供求频道、采集管理 、专题频道等等。系统通用模块：用户管理、博客日志管理、相册管理、音乐盒管理、朋友圈管理、广告管理、公告管理、模板管理、网站信息配置、高级自定义SQL扩展标签，RSS在线订阅功能、网站统计、邮件列表、邮件群发、数据库管理、站内短消
立即学习“Python免费学习笔记（深入）”；
按需启用调试：运行时动态调整模块级别
上线后通常只需 INFO 级别，但排查问题时可能需要临时提高某模块的日志量。可在启动时读取环境变量或命令行参数：
- 例如设置
LOG_LEVEL_DB=DEBUG，在集中配置中读取该变量，为"db"logger 单独设为 DEBUG - 或在主程序中执行
logging.getLogger("db").setLevel(logging.DEBUG)—— 这不会影响其他模块，且比改代码重启更快
避免常见陷阱
不要在包的 __init__.py 中调用 logging 配置；不要用 print() 替代日志；不要为每个函数新建 logger 实例。统一配置后，新增模块无需任何日志相关代码，只要 import logging + getLogger(__name__) 就自动接入整个日志体系。
