深入详解Python日志配置模板的全攻略

version: 1

formatters:
  standard:
    format: "%(asctime)s | %(name)s | %(levelname)s | %(funcName)s:%(lineno)d | %(message)s"
    datefmt: "%Y-%m-%d %H:%M:%S"

  simple:
    format: "%(name)s | %(levelname)s | %(message)s"

handlers:
  console:
    class: logging.StreamHandler
    level: INFO
    formatter: simple
    stream: ext://sys.stderr

  file:
    class: logging.handlers.RotatingFileHandler
    level: DEBUG
    formatter: standard
    filename: logs/app.log
    maxBytes: 10485760  # 10MB
    backupCount: 5      # 保留 5 个旧日志文件

loggers:
  app:
    level: DEBUG
    handlers: [console, file]
    propagate: true  # 重要：让日志传给 root

  app.api:
    level: DEBUG
    handlers: [console, file]
    propagate: true

  app.db:
    level: DEBUG
    handlers: [console, file]
    propagate: true

  app.utils:
    level: INFO
    handlers: [console, file]
    propagate: true

root:
  level: DEBUG
  handlers: [console, file]
  propagate: false  # 一般不建议设为 false，除非你明确不想传

import logging.config
import yaml
import os

# 确保 logs 目录存在
os.makedirs("logs", exist_ok=True)

# 加载 YAML 配置
def setup_logging(config_path="config/logging.yaml"):
    with open(config_path, "r", encoding="utf-8") as f:
        config = yaml.safe_load(f)
    logging.config.dictConfig(config)
    print("✅ 日志系统已配置完成！")

# 启动时调用
if __name__ == "__main__":
    setup_logging()
    logger = logging.getLogger("app")

    logger.info("🚀 应用启动成功！")
    logger.debug("调试信息：初始化完成")

import logging

logger = logging.getLogger("app.api")  # 模块化命名

def get_user(user_id: int):
    logger.debug("开始查询用户，user_id=%d", user_id)
    try:
        # 模拟数据库查询
        user = {"id": user_id, "name": "张三"}
        logger.info("成功查询用户: %s", user)
        return user
    except Exception as e:
        logger.error("查询用户失败，user_id=%d, 错误: %s", user_id, str(e))
        raise

PyYAML>=6.0