Python logging模块需避免root logger，按模块名（如"app.db"）创建独立logger并设不同级别；通过多个Handler实现多目标输出；用dictConfig动态适配环境；注意basicConfig只生效一次、防Handler重复添加等陷阱。
Python的logging模块远不止logging.basicConfig()和logger.info()这么简单。真正实用的项目中，需要按模块分级输出、区分开发/生产环境、同时写入文件和控制台、甚至动态调整日志级别——这些都依赖对Handler、Formatter、Filter和Logger层级关系的精准控制。
按模块设置不同日志级别
大型项目常需让核心模块（如数据库操作）输出DEBUG级日志，而UI层只记录WARNING以上。关键在于**避免使用root logger**，而是为每个模块创建独立命名的logger：
- 在
db.py中：logger = logging.getLogger("app.db")，再调用logger.setLevel(logging.DEBUG) - 在
ui.py中：logger = logging.getLogger("app.ui")，设为WARNING - 所有logger共享同一组Handler（如一个FileHandler），但各自级别独立生效
- 注意：logger名带点号（如
"app.db"）会自动构成层级关系，"app"的级别不会覆盖子logger的显式设置
多目标输出：控制台+文件+错误专用文件
一个典型配置是：INFO及以上写入主日志文件，ERROR单独存到error.log，同时DEBUG以上实时打印到终端。这需要多个Handler协同工作：
- 创建
RotatingFileHandler处理主日志，设level=logging.INFO - 创建第二个
RotatingFileHandler专捕ERROR，用setLevel(logging.ERROR)并添加Filter确保只传ERROR - 用
StreamHandler输出到终端，设为DEBUG，再配自定义Formatter加颜色（可用colorama或ANSI转义） - 所有Handler都add到同一个logger（如
logging.getLogger("app")），而非分别add到不同logger
环境感知配置：开发/测试/生产自动切换
通过读取环境变量或配置文件，动态加载不同策略：
立即学习“Python免费学习笔记（深入）”；
- 用
logging.config.dictConfig()替代代码式配置，把不同环境的handler、formatter、loggers结构写成字典 - 开发环境：启用
consolehandler +DEBUG，格式含行号和函数名 - 生产环境：禁用console，启用
TimedRotatingFileHandler按天切分，格式精简（去掉冗余字段），级别设为WARNING - 关键技巧：在dict中用
"disable_existing_loggers": False，防止覆盖第三方库日志配置
实战建议：避免常见陷阱
很多问题源于对logging机制的误解：
-
不要在模块顶层反复调用
basicConfig()——它只生效一次，后续调用无效；应统一在程序入口（如main.py）配置 -
Handler被重复add：若模块被多次导入，logger可能积累多个相同Handler，导致日志重复打印；可在add前检查
if not logger.handlers: -
敏感信息脱敏：在自定义
Filter中正则匹配密码、token字段并替换，比在业务代码里手动处理更可靠 -
异步日志写入：高并发场景下，用
QueueHandler+QueueListener将日志IO移到后台线程，避免阻塞主线程
掌握这些技巧后，日志就不再是调试辅助，而是系统可观测性的基础设施。配置本身不复杂，但细节决定是否真正可用。
