无需调用tee的Python subprocess同时输出到终端和日志的最简接口是什么？

你要的这种调用方式有成熟的实现方案，不需要修改原有subprocess调用的整体逻辑，两种可选实现方式如下：

方案1：使用第三方包subprocess-tee #

这个包专门适配subprocess原生接口，完全匹配你的使用场景：

• 安装命令：pip install subprocess-tee
• 使用示例：

import sys
from subprocess_tee import run

# 直接替换原有subprocess.run即可，其他参数完全兼容原生写法
run(
    ["ls", "-l"],
    stdout=sys.stdout,
    stdout_log="out.log",
    stderr=sys.stderr,
    stderr_log="err.log",
    append=True, # 对应shell tee命令的-a追加参数
    check=True # 其他原生subprocess支持的参数都可直接使用
)

方案2：自研轻量分流类，无额外依赖 #

如果不想引入第三方依赖，自己实现一个符合文件对象协议的分流类即可，代码量极小：

import sys

class TeeWriter:
    def __init__(self, *outputs, append=False):
        self.outputs = []
        for out in outputs:
            if isinstance(out, str):
                # 字符串参数视为日志文件路径
                self.outputs.append(open(out, "a" if append else "w"))
            else:
                # 其他参数视为已打开的流（如sys.stdout、sys.stderr）
                self.outputs.append(out)
    
    def write(self, data):
        for out in self.outputs:
            out.write(data)
            out.flush() # 实时刷缓冲，避免日志延迟
    
    def flush(self):
        for out in self.outputs:
            out.flush()
    
    def close(self):
        for out in self.outputs:
            # 仅关闭我们主动打开的文件，不销毁全局流
            if hasattr(out, "close") and out not in (sys.stdout, sys.stderr):
                out.close()

调用方式完全符合你预期的写法：

import subprocess

subprocess.run(
    ["ls", "-l"],
    stdout=TeeWriter(sys.stdout, "out.log", append=True),
    stderr=TeeWriter(sys.stderr, "err.log", append=True),
    text=True # 开启文本模式，和TeeWriter的字符串写入逻辑匹配
)

注意事项 #

• 如果你的subprocess调用使用二进制模式（未开启text/encoding参数），只需把传入的字节数据直接写入流即可，无需修改其他逻辑。
• 上述两种方案均支持实时输出，和shell中tee命令的行为完全一致，不会等到子进程退出才批量写入日志。

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