首页 > 脚本专栏 > python > Python logging创建和处理.log文件

Python使用logging模块创建和处理.log文件的多种方法

2026-04-13 09:27:07 作者：独隅

本文介绍了在Python中创建和处理.log文件的方法,推荐使用内置的logging模块,并详细描述了基础版、进阶版和专业版的实现方案,其中包括文件创建、日志级别、大小切割、日期切割、格式定制、多输出目标、高级功能等关键功能的说明和实现方式,需要的朋友可以参考下

在 Python 中创建和处理 .log 文件，推荐使用内置的 logging 模块。以下是完整的实现方案：

基础版：创建单个日志文件

import logging

# 基本配置
logging.basicConfig(
    filename='application.log',  # 日志文件名
    level=logging.DEBUG,         # 记录级别（DEBUG及以上都会记录）
    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
)

# 使用日志
logging.debug('这是一条调试信息')
logging.info('程序正常启动')
logging.warning('磁盘空间不足50%')
logging.error('数据库连接失败')

进阶版：日志分时分割 (按日期)

from logging.handlers import TimedRotatingFileHandler
import logging

logger = logging.getLogger(__name__)
logger.setLevel(logging.INFO)

# 创建按天分割的日志处理器
handler = TimedRotatingFileHandler(
    'daily_log.log',
    when='midnight',  # 每天午夜分割
    interval=1,
    backupCount=7     # 保留最近7天的日志
)
formatter = logging.Formatter('%(asctime)s - %(levelname)s - %(message)s')
handler.setFormatter(formatter)

logger.addHandler(handler)

# 使用日志
logger.info("这条日志会按天自动分割")

专业版：多类型日志处理器组合

import logging
from logging.handlers import RotatingFileHandler

# 创建不同处理器
debug_handler = RotatingFileHandler(
    'debug.log',
    maxBytes=1024*1024,  # 1MB
    backupCount=3
)
debug_handler.setLevel(logging.DEBUG)

error_handler = RotatingFileHandler(
    'errors.log',
    maxBytes=1024*1024,
    backupCount=1
)
error_handler.setLevel(logging.ERROR)

# 创建带颜色的控制台输出
console = logging.StreamHandler()
console.setLevel(logging.INFO)

# 创建格式器
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
debug_handler.setFormatter(formatter)
error_handler.setFormatter(formatter)
console.setFormatter(logging.Formatter('%(levelname)s: %(message)s'))

# 配置根日志器
root_logger = logging.getLogger()
root_logger.setLevel(logging.DEBUG)
root_logger.addHandler(debug_handler)
root_logger.addHandler(error_handler)
root_logger.addHandler(console)

# 测试日志
logging.debug("开发调试信息")
logging.info("用户登录成功")
logging.warning("接口响应时间过长")
logging.error("支付服务连接超时")

关键功能说明

功能	实现方式
文件创建	`logging.basicConfig(filename='...')`
日志级别	DEBUG < INFO < WARNING < ERROR < CRITICAL
大小切割	`RotatingFileHandler`
日期切割	`TimedRotatingFileHandler`
格式定制	`logging.Formatter()` 支持日期、进程信息等
多输出目标	添加多个处理器到日志器

高级功能

结构化日志 (适合JSON格式)

import json
from logging import Formatter

class JsonFormatter(Formatter):
    def format(self, record):
        log_record = {
            'time': self.formatTime(record),
            'level': record.levelname,
            'message': record.getMessage(),
            'module': record.module
        }
        return json.dumps(log_record)

formatter = JsonFormatter()

日志过滤

class NoDebugFilter(logging.Filter):
    def filter(self, record):
        return record.levelno < logging.DEBUG

debug_handler.addFilter(NoDebugFilter())

日志管理最佳实践

目录结构

project/
├── logs/
│   ├── debug.log
│   ├── info.log
│   └── errors.log
└── main.py

推荐配置

import os
from pathlib import Path

# 创建日志目录
log_dir = Path('logs')
log_dir.mkdir(exist_ok=True)

# 主日志配置
logging.basicConfig(
    level=logging.INFO,
    handlers=[
        RotatingFileHandler(log_dir/'app.log', maxBytes=10*1024*1024, backupCount=5),
        logging.StreamHandler()
    ],
    format='[%(asctime)s] %(levelname)s in %(module)s: %(message)s'
)

环境区分

if os.getenv('FLASK_ENV') == 'development':
    logging.getLogger().setLevel(logging.DEBUG)
else:
    logging.getLogger().setLevel(logging.WARNING)

使用这些方法，您可以创建专业级的日志系统，满足从简单记录到企业级应用的各种需求。

以上就是Python使用logging模块创建和处理.log文件的多种方法的详细内容，更多关于Python logging创建和处理.log文件的资料请关注脚本之家其它相关文章！