Python logging 模块的原理和常用配置

import logging
# 创建格式化器：自定义输出格式 + 时间格式
formatter = logging.Formatter(
    fmt='%(asctime)s - %(name)s - %(levelname)s - %(filename)s:%(lineno)d - %(message)s',
    datefmt='%Y-%m-%d %H:%M:%S'  # 自定义时间格式，可选
)

# 1. 控制台处理器
console_handler = logging.StreamHandler()
console_handler.setLevel(logging.INFO)  # 处理器级别（仅输出≥该级别的日志）
console_handler.setFormatter(formatter)  # 绑定格式化器
# 2. 文件处理器（按大小分割，单个文件最大10MB，保留5个备份）
from logging.handlers import RotatingFileHandler
file_handler = RotatingFileHandler(
    filename='app.log',
    maxBytes=10*1024*1024,  # 10MB
    backupCount=5,
    encoding='utf-8'  # 避免中文乱码
)
file_handler.setLevel(logging.DEBUG)
file_handler.setFormatter(formatter)

# 1. 获取日志器（推荐使用模块名/项目名作为名称，避免全局冲突）
logger = logging.getLogger('my_blog_app')
# 2. 设置日志器级别（全局过滤，优先级最高）
logger.setLevel(logging.DEBUG)
# 3. 绑定处理器（可绑定多个）
logger.addHandler(console_handler)
logger.addHandler(file_handler)
# 4. 禁用日志传播（避免子日志器的日志被父日志器重复处理）
logger.propagate = False
# 5. 输出日志
logger.debug('调试信息：数据库连接参数')
logger.info('正常信息：用户登录成功')
logger.warning('警告信息：密码复杂度不足')
logger.error('错误信息：接口调用失败')
logger.critical('严重错误：数据库连接中断')

import logging
from logging.handlers import RotatingFileHandler
import os
def setup_logger():
    """配置全局日志器"""
    # 1. 定义日志器名称（推荐用项目名）
    logger = logging.getLogger('blog_demo')
    # 防止重复添加处理器（多次调用该函数时）
    if logger.handlers:
        return logger
    # 2. 设置日志器全局级别（最低级别，让处理器过滤）
    logger.setLevel(logging.DEBUG)
    # 禁用日志传播，避免根日志器重复输出
    logger.propagate = False
    # 3. 创建格式化器
    formatter = logging.Formatter(
        fmt='%(asctime)s [%(threadName)s:%(thread)d] [%(name)s:%(lineno)d] %(levelname)s - %(message)s',
        datefmt='%Y-%m-%d %H:%M:%S',
        encoding='utf-8'
    )
    # 4. 配置控制台处理器（仅输出INFO及以上）
    console_handler = logging.StreamHandler()
    console_handler.setLevel(logging.INFO)
    console_handler.setFormatter(formatter)
    # 5. 配置文件处理器（输出DEBUG及以上，按大小分割）
    # 确保日志目录存在
    log_dir = 'logs'
    if not os.path.exists(log_dir):
        os.makedirs(log_dir)
    file_handler = RotatingFileHandler(
        filename=os.path.join(log_dir, 'app.log'),
        maxBytes=5*1024*1024,  # 5MB
        backupCount=10,        # 保留10个备份
        encoding='utf-8'       # 中文编码
    )
    file_handler.setLevel(logging.DEBUG)
    file_handler.setFormatter(formatter)
    # 6. 绑定处理器到日志器
    logger.addHandler(console_handler)
    logger.addHandler(file_handler)
    return logger
# 使用示例
if __name__ == '__main__':
    logger = setup_logger()
    logger.debug('这是调试信息，仅输出到文件')
    logger.info('这是普通信息，控制台和文件都输出')
    logger.warning('这是警告信息')
    logger.error('这是错误信息')
    logger.critical('这是严重错误信息')