在Debian系统上配置Python的日志，其实有一套标准流程，下面就来一步步拆解。

1. 安装必要的库

先说基础：确保系统里已经装好了Python和相关的日志库。通常情况下，这些库都随标准Python安装包一起提供，不需要额外操心。但如果你是从零开始的干净系统，执行下面两条命令就行：

sudo apt update
sudo apt install python3 python3-pip

2. 配置日志记录

Python自带的logging模块是最常用的日志工具，没有之一。它足够灵活，能满足大部分场景。下面是一个最基础的配置示例：

示例代码

import logging

# 配置日志记录
logging.basicConfig(
    level=logging.DEBUG,  # 设置日志级别
    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',  # 设置日志格式
    datefmt='%Y-%m-%d %H:%M:%S',  # 设置日期时间格式
    filename='app.log',  # 日志文件名
    filemode='a'  # 追加模式
)

# 获取日志记录器
logger = logging.getLogger(__name__)

# 记录不同级别的日志
logger.debug('This is a debug message')
logger.info('This is an info message')
logger.warning('This is a warning message')
logger.error('This is an error message')
logger.critical('This is a critical message')

这段代码一跑，日志就会乖乖写入 app.log 文件，并且按你设定的格式和级别输出。非常直观。

3. 配置日志轮转

日志文件如果不管，迟早会撑爆磁盘。解决办法就是日志轮转——按大小或时间自动切分文件。Python的 logging.handlers 里提供了两种现成的轮转机制：RotatingFileHandler（按大小）和 TimedRotatingFileHandler（按时间）。这里以按大小轮转为例：

示例代码（使用RotatingFileHandler）

import logging
from logging.handlers import RotatingFileHandler

# 配置日志记录
logging.basicConfig(
    level=logging.DEBUG,
    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
    datefmt='%Y-%m-%d %H:%M:%S'
)

# 获取日志记录器
logger = logging.getLogger(__name__)
logger.setLevel(logging.DEBUG)

# 创建一个RotatingFileHandler，最大文件大小为1MB，最多保留3个备份文件
handler = RotatingFileHandler('app.log', maxBytes=1*1024*1024, backupCount=3)
handler.setLevel(logging.DEBUG)

# 设置日志格式
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
handler.setFormatter(formatter)

# 添加处理器到日志记录器
logger.addHandler(handler)

# 记录不同级别的日志
logger.debug('This is a debug message')
logger.info('This is an info message')
logger.warning('This is a warning message')
logger.error('This is an error message')
logger.critical('This is a critical message')

这里的关键参数是 maxBytes 和 backupCount：前者控制单个文件最大体积（示例中设为1MB），后者指定保留的历史备份文件数量（示例中保留3个）。当文件超过1MB时，自动压缩并滚动，既省空间又方便回溯。

4. 使用系统日志

有些场景下，我们希望Python日志直接进入系统日志服务（比如 syslog），这样就能和系统其他日志统一管理、统一轮转。实现起来也不复杂，用 SysLogHandler 即可：

示例代码（使用SysLogHandler）

import logging
from logging.handlers import SysLogHandler

# 配置日志记录
logging.basicConfig(
    level=logging.DEBUG,
    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
    datefmt='%Y-%m-%d %H:%M:%S'
)

# 获取日志记录器
logger = logging.getLogger(__name__)
logger.setLevel(logging.DEBUG)

# 创建一个SysLogHandler，发送日志到系统日志
handler = SysLogHandler(address='/dev/log')
handler.setLevel(logging.DEBUG)

# 设置日志格式
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
handler.setFormatter(formatter)

# 添加处理器到日志记录器
logger.addHandler(handler)

# 记录不同级别的日志
logger.debug('This is a debug message')
logger.info('This is an info message')
logger.warning('This is a warning message')
logger.error('This is an error message')
logger.critical('This is a critical message')

注意 address='/dev/log' 是Debian系统上syslog的默认套接字路径。如果你用的是其他发行版或容器环境，可能需要调整为 ('/localhost', 514) 这样的网络地址。

以上就是在Debian系统上配置Python日志的完整流程。从基础配置到日志轮转，再到系统日志集成，每一步都有对应的工具和方法。实际使用时，根据项目需求组合这些处理器，就能搭建一套既灵活又可靠的日志体系。

《夸克》非常好用的免费AI浏览器

下载APP查看