如何为启用log_cli的pytest配置自定义日志格式化器？

我刚好折腾过这个问题，pytest默认的CLI日志确实会用一套硬编码的格式，要用上自己的自定义格式化器，你可以试试这几个实用方法：

方法1：通过pytest_configure钩子替换格式化器 #

这是最简洁的方案，不用大改配置，只需要在项目的conftest.py里加一段代码，在pytest初始化时替换掉CLI日志处理器的格式化器：

import logging
from your_module import YourCustomFormatter  # 导入你自己的格式化器类

def pytest_configure(config):
    # 确认CLI日志已启用
    if config.getoption("log_cli"):
        # 遍历根logger的所有处理器，找到pytest的CLI日志处理器
        for handler in logging.getLogger().handlers:
            if isinstance(handler.formatter, logging.Formatter):
                # 替换成自定义格式化器
                handler.setFormatter(YourCustomFormatter())
                break

说明 #

pytest_configure是pytest的核心钩子函数，会在测试会话启动前执行。这里我们找到根logger下的控制台处理器，直接替换它的格式化器为你实现的类，就能让pytest的CLI日志用你的格式输出了。记得删掉pytest.ini里的log_format、log_cli_format这些配置，避免冲突。

方法2：完全接管日志系统，禁用pytest默认CLI日志 #

如果第一种方法不生效（比如某些pytest版本的处理器结构不同），可以直接禁用pytest自带的CLI日志，自己配置控制台处理器：

首先修改pytest.ini：

[pytest]
log_cli = false

然后在conftest.py里添加：

import logging
from your_module import YourCustomFormatter

def pytest_configure(config):
    # 强制关闭pytest默认CLI日志
    config.option.log_cli = False
    
    # 获取根logger，清除现有处理器（避免重复输出）
    root_logger = logging.getLogger()
    for handler in root_logger.handlers[:]:
        root_logger.removeHandler(handler)
    
    # 添加自定义控制台处理器
    console_handler = logging.StreamHandler()
    console_handler.setFormatter(YourCustomFormatter())
    root_logger.addHandler(console_handler)
    
    # 对齐pytest的日志级别配置（可选，保持和log_cli_level一致）
    root_logger.setLevel(config.getoption("log_cli_level"))

说明 #

这种方式完全绕过pytest的日志系统，直接用Python标准库的logging模块配置日志，能确保100%使用你的自定义格式化器，适合需要完全控制日志行为的场景。

方法3：加载已有的日志配置文件 #

如果你已经通过logging.config.fileConfig或者dictConfig定义了完整的日志配置（包含自定义格式化器），可以直接在pytest启动时加载这个配置：

import logging.config

def pytest_configure(config):
    # 加载你的日志配置文件（比如logging.conf）
    logging.config.fileConfig("logging.conf", disable_existing_loggers=False)
    # 禁用pytest默认CLI日志，避免冲突
    config.option.log_cli = False

注意点 #

disable_existing_loggers=False一定要加上，不然会把项目中已有的logger全部禁用，导致日志丢失。

内容的提问来源于stack exchange，提问作者Meru