如何通过subprocess实时按原顺序捕获并打印stdout与stderr

开发者阿泽

2026-8-2

解决subprocess调用脚本时stdout/stderr输出顺序错乱问题

问题根源

默认情况下，subprocess通过管道获取stdout时，终端会对其启用行缓冲或全缓冲，而stderr默认是无缓冲的。这就导致子进程的stderr内容会实时输出，而stdout内容被缓存，直到子进程结束才批量输出，打破了原脚本的输出顺序。

解决方案

通过多线程分别监听stdout和stderr流，一旦读取到内容就立刻输出到对应目标，保证输出顺序与原脚本一致，同时保留两个流的独立输出目标。

示例代码

printer.py（原脚本）

import sys
import time

print("STDOUT 1", flush=True)
time.sleep(0.1)
print("STDERR 2", file=sys.stderr, flush=True)
time.sleep(0.1)
print("STDOUT 3", flush=True)
time.sleep(0.1)
print("STDERR 4", file=sys.stderr, flush=True)

runner.py（修正后的调用脚本）

import subprocess
import sys
from threading import Thread

def stream_reader(stream, output_target):
    """读取子进程输出流并实时打印到指定目标"""
    for line in iter(stream.readline, b''):
        output_target.write(line.decode())
        output_target.flush()

# 启动子进程，启用管道获取stdout和stderr
proc = subprocess.Popen(
    ["python", "printer.py"],
    stdout=subprocess.PIPE,
    stderr=subprocess.PIPE,
    text=False
)

# 创建线程分别处理两个流
stdout_thread = Thread(target=stream_reader, args=(proc.stdout, sys.stdout))
stderr_thread = Thread(target=stream_reader, args=(proc.stderr, sys.stderr))

# 启动线程并等待结束
stdout_thread.start()
stderr_thread.start()

stdout_thread.join()
stderr_thread.join()
proc.wait()