Python利用logging模块实现不同级别彩色日志输出

阿橙

发布时间：2026-10-16| 2人浏览过

原创

本文详解如何在Python中使用logging模块结合colorlog库实现不同日志级别的彩色输出。通过配置ConsoleHandler和FileHandler，分别将warning及以上级别日志在控制台以颜色显示，并将error及critical级别日志写入文件。文章提供完整代码示例，展示如何自定义日志格式、颜色映射及处理器添加方法，帮助开发者提升日志可读性与调试效率。

Python日志模块核心组件解析

logger是日志器对象，可通过logging.getLogger()方法获取。

handler是处理器对象，负责将日志信息输出到指定位置，可通过logger.addHandler()方法进行添加。

formatter是格式器对象，用于输出格式化后的日志字符串。

当同一应用程序存在不同的日志需求时，例如将error级别的日志在控制台输出，而critical级别的日志写入日志文件，就需要配置不同的handler来实现，并通过logger.addHandler()方法将它们均添加到logger中。

实现分级彩色日志输出的代码示例

具体实现代码如下：

# coding:utf-8
import logging
import colorlog
class Log:
    def __init__(self,name=None,log_level=logging.DEBUG):
        # 获取logger对象
        self.logger = logging.getLogger(name)

        # 避免重复打印日志
        self.logger.handlers = []

        # 指定最低日志级别：（critical > error > warning > info > debug）
        self.logger.setLevel(log_level)

        # 日志格化字符串
        console_fmt = '%(log_color)s%(asctime)s-%(threadName)s-%(filename)s-[line:%(lineno)d]-%(levelname)s: %(message)s'
        file_fmt = '%(asctime)s-%(threadName)s-%(filename)s-[line:%(lineno)d]-%(levelname)s: %(message)s'

        # 控制台输出不同级别日志颜色设置
        color_config = {
            'DEBUG': 'cyan',
            'INFO': 'green',
            'WARNING': 'yellow',
            'ERROR': 'red',
            'CRITICAL': 'purple',
        }

        console_formatter = colorlog.ColoredFormatter(fmt=console_fmt,log_colors=color_config)
        file_formatter = logging.Formatter(fmt=file_fmt)

        # 输出到控制台
        console_handler = logging.StreamHandler()
        # 输出到文件
        file_handler = logging.FileHandler(filename=name,mode='a',encoding='utf-8')

        # 设置日志格式
        console_handler.setFormatter(console_formatter)
        file_handler.setFormatter(file_formatter)

        # 处理器设置日志级别，不同处理器可各自设置级别，默认使用logger日志级别
        # console_handler.setLevel(logging.WARNING)
        file_handler.setLevel(logging.ERROR) # 只有error和critical级别才会写入日志文件

        # logger添加处理器
        self.logger.addHandler(console_handler)
        self.logger.addHandler(file_handler)

    def debug(self,message):
        self.logger.debug(message)

    def info(self,message):
        self.logger.info(message)

    def warning(self,message):
        self.logger.warning(message)

    def error(self,message):
        self.logger.error(message)

    def critical(self,message):
        self.logger.critical(message)

if __name__ == '__main__':
    # 控制台只会显示warning及以上级别日志信息，而log.txt文件中则会记录error及以上级别日志信息
    log = Log(name='log.txt',log_level=logging.WARNING)
    log.debug('debug')
    log.info('info')
    log.warning('warning')
    log.error('error')
    log.critical('critical')

最终控制台将按照指定颜色输出warning及以上级别的日志内容。