如何为Python日志的文件处理器配置格式化器以移除ANSI转义字符

嗨，这个需求其实很好实现，咱们核心思路就是给两个日志处理器分别配置不同的格式化规则——让控制台输出保留彩色样式，文件输出自动剥离那些ANSI转义字符。下面给你一步步拆解具体代码：

1. 先实现移除ANSI转义字符的工具函数 #

首先咱们需要一个能识别并移除所有ANSI转义序列的函数，用正则表达式就能轻松搞定：

import re

# 匹配所有ANSI转义序列的正则表达式
ANSI_ESCAPE_PATTERN = re.compile(r'\x1B(?:[@-Z\\-_]|\[.*?[a-zA-Z])')

def strip_ansi_escape_codes(text: str) -> str:
    """移除字符串中的所有ANSI转义字符"""
    return ANSI_ESCAPE_PATTERN.sub('', text)

这个正则能匹配绝大多数常见的ANSI转义序列（包括颜色、字体样式、光标控制等），替换成空字符串就干净了。

2. 为两个处理器配置差异化的格式化器 #

接下来咱们给控制台和文件处理器分别设置格式化逻辑：

import logging

# 定义基础的日志格式（这里可以用你自己原来的格式）
LOG_FORMAT = "%(asctime)s - %(name)s - %(levelname)s - %(message)s"

# ---------------------- 控制台处理器：保留ANSI颜色 ----------------------
console_handler = logging.StreamHandler()
# 直接用普通的格式化器，不做任何额外处理，保留原始的彩色日志
console_formatter = logging.Formatter(LOG_FORMAT)
console_handler.setFormatter(console_formatter)

# ---------------------- 文件处理器：移除ANSI颜色 ----------------------
# 自定义一个格式化器，继承自logging.Formatter，重写format方法
class NoColorFormatter(logging.Formatter):
    def format(self, record):
        # 先调用父类的format方法，得到完整的日志内容（可能带ANSI字符）
        raw_log = super().format(record)
        # 移除ANSI转义字符后返回
        return strip_ansi_escape_codes(raw_log)

file_handler = logging.FileHandler('app.log')
# 使用咱们自定义的无颜色格式化器
file_formatter = NoColorFormatter(LOG_FORMAT)
file_handler.setFormatter(file_formatter)

3. 配置Logger并测试 #

最后把两个处理器添加到你的日志实例里，就可以测试效果了：

# 初始化并配置logger
logger = logging.getLogger(__name__)
logger.setLevel(logging.DEBUG)
# 添加两个处理器
logger.addHandler(console_handler)
logger.addHandler(file_handler)

# 测试带颜色的日志输出
# 模拟你原来的带[32mPASS[0m的日志
logger.info("\033[32mPASS\033[0m - 登录接口测试通过")
logger.error("\033[31mFAIL\033[0m - 支付接口请求超时")

运行这段代码后：

• 控制台会看到绿色的PASS和红色的FAIL，保留原有彩色样式
• 打开app.log文件，里面的日志会是PASS - 登录接口测试通过和FAIL - 支付接口请求超时，完全没有那些[32m、[0m之类的转义字符

额外小提示 #

• 如果你的彩色日志是通过第三方库（比如colorlog）生成的，这个方案同样适用，因为最终的日志消息里还是会包含ANSI转义序列，自定义格式化器会自动处理
• 要是你不想自定义类，也可以在给文件处理器设置格式化器时，直接在format方法里手动处理，但用类的方式更优雅、更易维护

备注：内容来源于stack exchange，提问作者Adiel