Python中如何使用subprocess捕获输出同时将其打印到屏幕？

这个需求我太懂了！之前写Python脚本的时候也纠结过——既要实时看到子进程的操作输出，又要把内容抓下来存文件或者做后续处理。其实有几个实用的方法可以解决，分场景给你说说：

方法一：利用系统tee命令（类Unix系统首选） #

如果你是在Linux/macOS这类类Unix环境下，直接借助系统自带的tee命令就能轻松实现。tee的作用就是把输入同时输出到屏幕和指定文件，我们可以通过shell管道把目标程序的输出传给它：

import subprocess

# 同时将输出打印到屏幕，并存入output.txt，还能通过proc.stdout捕获内容
proc = subprocess.run(
    "your_program | tee output.txt",
    shell=True,
    stdout=subprocess.PIPE,
    stderr=subprocess.STDOUT,
    text=True
)

# 从proc.stdout获取捕获到的完整输出
captured_output = proc.stdout

⚠️ 注意：使用shell=True时，如果命令包含用户输入的内容，要警惕命令注入风险，确保输入是安全可控的。

方法二：Python原生跨平台实现（推荐） #

如果需要跨Windows和类Unix系统运行，或者不想依赖shell命令，可以用subprocess.Popen替代run，手动实时读取子进程的输出流，一边打印到屏幕一边保存：

import subprocess

def capture_and_stream_output(cmd):
    """同时捕获子进程输出并实时打印到屏幕"""
    captured_lines = []
    # 启动子进程，启用行缓冲保证实时输出
    proc = subprocess.Popen(
        cmd,
        stdout=subprocess.PIPE,
        stderr=subprocess.STDOUT,  # 把stderr合并到stdout一起处理
        text=True,
        bufsize=1,  # 行缓冲模式
        universal_newlines=True
    )

    # 逐行读取输出，直到子进程结束
    for line in iter(proc.stdout.readline, ''):
        print(line, end='')  # 打印到终端（end=''避免重复换行）
        captured_lines.append(line)  # 保存到列表

    # 等待子进程完成并获取返回码
    proc.wait()
    return ''.join(captured_lines), proc.returncode

# 使用示例
output, return_code = capture_and_stream_output("your_program")

# 把捕获的内容写入文件
with open("output.txt", "w", encoding="utf-8") as f:
    f.write(output)

这个方法完全用Python原生实现，不依赖系统工具，而且能精确控制输出的处理逻辑，适合大多数跨平台场景。

方法三：底层文件描述符复制（进阶） #

如果你需要更底层的控制，可以通过os.dup2复制文件描述符，把子进程的输出同时定向到终端和我们的捕获管道：

import subprocess
import os
import sys

def tee_output(cmd):
    # 保存当前终端的stdout文件描述符
    original_stdout = os.dup(sys.stdout.fileno())
    # 创建管道用于捕获输出
    read_fd, write_fd = os.pipe()

    # 将当前进程的stdout重定向到管道的写端
    os.dup2(write_fd, sys.stdout.fileno())
    os.close(write_fd)

    # 启动子进程，它会继承当前的stdout（也就是管道）
    proc = subprocess.Popen(cmd, shell=True)

    # 读取管道内容，同时打印到原终端并保存
    captured_content = []
    with os.fdopen(read_fd, 'r', encoding="utf-8") as pipe_reader:
        for line in pipe_reader:
            # 把内容写回原终端
            os.write(original_stdout, line.encode())
            captured_content.append(line)

    # 等待子进程结束，恢复原stdout
    proc.wait()
    os.dup2(original_stdout, sys.stdout.fileno())
    os.close(original_stdout)

    return ''.join(captured_content)

# 使用示例
captured = tee_output("your_program")

这个方法偏底层，适合需要自定义输出流向的复杂场景，但要注意操作完后一定要恢复原stdout，避免影响后续的终端输出。

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