搞定Python日志配置，再也不怕系统出问题！从零基础到精通，收藏这篇就够了！

本文链接：https://blog.youkuaiyun.com/Javachichi/article/details/145872288

很多开发者都有这样的经历：深夜收到系统报警，打开代码一看，全是print()语句，根本无法定位问题。今天就来聊聊如何配置Python日志系统，让问题排查变得轻松自如！

日志配置基础

最简配置示例

import logging      # 基础配置   logging.basicConfig(       level=logging.INFO,       format='%(asctime)s - %(levelname)s - %(message)s',       filename='app.log'   )      # 使用日志   logger = logging.getLogger(__name__)   logger.info("系统启动成功")

🌟小贴士：使用__name__作为logger名称可以清晰定位日志来源，方便后期问题排查。

日志级别详解

从低到高分别是：

DEBUG：记录详细的调试信息
INFO：记录程序正常运行的信息
WARNING：记录潜在的问题或即将发生的问题
ERROR：记录错误信息，但不影响系统继续运行
CRITICAL：记录严重错误，可能导致程序崩溃

进阶配置技巧

1. 多目标输出

import logging   import sys      def create_logger(name):       logger = logging.getLogger(name)       logger.setLevel(logging.DEBUG)              # 文件输出       file_handler = logging.FileHandler('app.log', encoding='utf-8')       file_handler.setLevel(logging.INFO)              # 控制台输出       console_handler = logging.StreamHandler(sys.stdout)       console_handler.setLevel(logging.DEBUG)              # 日志格式       formatter = logging.Formatter(           '%(asctime)s [%(name)s] %(levelname)s: %(message)s'       )       file_handler.setFormatter(formatter)       console_handler.setFormatter(formatter)              logger.addHandler(file_handler)       logger.addHandler(console_handler)              return logger

⚠️注意：添加处理器后，日志会同时输出到所有处理器。如果不希望重复输出，记得设置propagate=False。

2. 日志文件自动切割

from logging.handlers import TimedRotatingFileHandler      def setup_rotating_logger(name):       logger = logging.getLogger(name)       handler = TimedRotatingFileHandler(           'logs/app.log',           when='midnight',           interval=1,           backupCount=30,           encoding='utf-8'       )       formatter = logging.Formatter(           '%(asctime)s - %(name)s - %(levelname)s - %(message)s'       )       handler.setFormatter(formatter)       logger.addHandler(handler)

💡技巧：设置backupCount可以控制保留的日志文件数量，避免占用过多磁盘空间。

3. 自定义日志格式化

class HighlightFormatter(logging.Formatter):       def format(self, record):           # 为不同级别添加不同颜色           if record.levelno == logging.ERROR:               record.levelname = '\033[31m%s\033[0m' % record.levelname           elif record.levelno == logging.WARNING:               record.levelname = '\033[33m%s\033[0m' % record.levelname           return super().format(record)

实战案例：接口服务日志配置

def setup_service_logger():       logger = logging.getLogger('service')              # 分离不同级别日志       info_handler = logging.FileHandler('logs/service.log')       info_handler.setLevel(logging.INFO)              error_handler = logging.FileHandler('logs/error.log')       error_handler.setLevel(logging.ERROR)              # 详细的格式       formatter = logging.Formatter(           '[%(asctime)s] %(levelname)s in %(module)s: %(message)s\n'           'Details: %(pathname)s:%(lineno)d'       )              info_handler.setFormatter(formatter)       error_handler.setFormatter(formatter)              logger.addHandler(info_handler)       logger.addHandler(error_handler)              return logger

动手练习：日志系统实战

完成以下需求：

"""   设计一个日志系统，满足以下要求：   1. DEBUG级别信息只输出到控制台   2. INFO及以上级别同时写入文件   3. ERROR级别发送邮件通知   4. 日志文件每天自动切割   5. 保留最近7天的日志   """      def build_logger():       # 实现你的代码       pass      # 测试代码   logger = build_logger()   logger.debug("开始处理数据...")   logger.info("成功处理100条记录")   logger.error("数据库连接失败")

参考实现：

import logging   from logging.handlers import TimedRotatingFileHandler, SMTPHandler      def build_logger():       logger = logging.getLogger('practice')       logger.setLevel(logging.DEBUG)              # 控制台输出       console = logging.StreamHandler()       console.setLevel(logging.DEBUG)       console.setFormatter(logging.Formatter('%(levelname)s: %(message)s'))              # 文件输出       file_handler = TimedRotatingFileHandler(           'logs/app.log',           when='midnight',           interval=1,           backupCount=7       )       file_handler.setLevel(logging.INFO)       file_handler.setFormatter(           logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')       )              # 邮件通知       mail_handler = SMTPHandler(           mailhost=('smtp.company.com', 587),           fromaddr='system@company.com',           toaddrs=['admin@company.com'],           subject='系统错误通知'       )       mail_handler.setLevel(logging.ERROR)              logger.addHandler(console)       logger.addHandler(file_handler)       logger.addHandler(mail_handler)              return logger

经过无数次的深夜排查问题，我深刻体会到一个完善的日志系统对于项目的重要性。好的日志配置不仅能帮助快速定位问题，还能帮助理解系统运行状态，甚至预防潜在的问题。

每次看到同事还在用print调试时，我都会建议他们切换到专业的日志系统。一个设计良好的日志系统就像给代码装上了"行车记录仪"，当系统出现问题时，我们总能找到线索。通过这篇文章的分享，希望能帮助更多开发者建立起正确的日志使用习惯。