Python 如何让 print() 输出到文件的同时保持彩色（ANSI）

在 Python 调试或写命令行工具时，我们常希望终端里用红色标出错误、绿色标出成功，同时把这些日志存到文件备查。但不少人发现，一旦把 print() 重定向到文件，颜色就没了。这并非 Python 删除了颜色，而是输出目标从“终端”变成“普通文件”后，部分封装库主动忽略了 ANSI 转义序列。只要理解原理并做一点封装，就能让文件原样保留彩色控制符。

为什么 print 到文件会丢失颜色

ANSI 颜色本质是形如 33[31m 的转义序列，它告诉支持该协议的终端如何着色。当你在交互式终端执行 print('33[31m错误33[0m')，屏幕显示红字。但若把输出通过 open('log.txt','w') 写入，文件本身不解释颜色，只会存下这些字符。真正让“颜色消失”的，往往是像 colorama 这类库：它们检测输出流是否是 tty（终端），如果不是就自动把转义符过滤掉。

Python 内置的 sys.stdout 在终端是带 isatty() 返回 True 的对象；而文件对象 isatty() 为 False。很多彩色日志方案基于此做降级。因此，保持彩色的关键就是绕过这种自动降级，强制把原始转义序列写进文件。

基础方案：直接写转义序列到文件

最简单的方法是不依赖任何第三方库，自己拼接 ANSI 码并用 print 的 file 参数指定输出。下面代码同时打印到终端和文件，且文件保留颜色：

import sys

RED = '33[31m'
RESET = '33[0m'

def print_color(msg, file=None):
    line = RED + msg + RESET
    # 终端总输出
    print(line, file=sys.stdout)
    # 如果传了文件对象，也写一份
    if file is not None:
        print(line, file=file)

with open('app.log', 'w') as f:
    print_color('数据库连接失败', file=f)

这段代码里，app.log 中会包含 33[31m数据库连接失败33[0m 原始字符。用 cat 或 VS Code 等支持 ANSI 的查看器打开，依旧是红色。注意用文本模式写即可，不需要二进制模式，因为转义序列就是普通字符。

缺点是手动拼字符串繁琐。若团队已用 colorama 或 rich，需配置它们不剥离文件流的颜色。

使用 colorama 强制保留颜色

colorama 通常在 Windows 下把 ANSI 转成 Win32 调用，在非 tty 时关闭转换。我们可以初始化时传入 strip=False 来禁止剥离：

import colorama
from colorama import Fore, Style

# strip=False 表示不对非 tty 输出剥离 ANSI
colorama.init(strip=False)

with open('color.log', 'w') as f:
    # 同时输出到文件和屏幕
    print(Fore.RED + '权限不足' + Style.RESET_ALL, file=f)
    print(Fore.RED + '权限不足' + Style.RESET_ALL)

这样 color.log 里就有完整 Fore.RED 对应的转义序列。该方式兼容已有 colorama 代码，只需改一处 init。但需注意，若文件被不支持 ANSI 的程序读取，会看到乱码状字符，这是预期现象。

如果希望更优雅，可封装一个多目标 writer，把每次写操作复制给终端和文件，避免重复 print 调用。

封装 Tee 类同时写屏与文件

模仿 Linux tee 命令，写一个类接收多个流，任何写入都广播出去。结合 print 的 file 参数即可：

import sys

class Tee:
    def __init__(self, *streams):
        self.streams = streams
    def write(self, data):
        for s in self.streams:
            s.write(data)
    def flush(self):
        for s in self.streams:
            s.flush()

# 终端和标准文件都保留
tee = Tee(sys.stdout, open('multi.log', 'w'))

print('33[32m任务完成33[0m', file=tee)
tee.flush()

Tee 对象不是 tty，但因为我们没用自动剥离库，转义序列直接落地。它把一份内容同时推给屏幕和文件，逻辑清晰，也方便扩展成网络发送。

要注意文件对象用完应关闭，生产环境可包成上下文管理器。此外 logging 模块也能接 StreamHandler 指向 Tee，统一日志格式。

与 logging 模块结合

若项目用 logging，可添加 StreamHandler 并把 stream 设为上面的 Tee，这样 logger.info 带色也能进文件：

import logging
import sys

class Tee:
    def __init__(self, *streams):
        self.streams = streams
    def write(self, data):
        for s in self.streams:
            s.write(data)
    def flush(self):
        for s in self.streams:
            s.flush()

tee = Tee(sys.stdout, open('run.log', 'w'))
handler = logging.StreamHandler(tee)
logging.basicConfig(level=logging.INFO, handlers=[handler])

# 手动加色
logging.info('33[33m警告：磁盘超过80%33[0m')

这样 run.log 中保留黄色警告原文。logging 本身不处理颜色，只负责传递字符串，因此只要输入端带了 ANSI 且 handler 不过滤，文件就原样存储。

总结来说，让 print 输出到文件且保留彩色，核心就是别让库“好心”剥掉转义符，并用多路写流确保同一份带色文本落盘。根据项目复杂度，从直接写文件到 Tee 封装都是可行路径。

PythonprintANSI_color修改时间：2026-08-10 03:42:30