用 subprocess 实时打印并捕获全部输出需用 Popen 配合 iter(proc.stdout.readline, '') 逐行读取，设置 text=True 和 bufsize=1，并对子进程加 -u 或 stdbuf 确保行缓冲；示例中执行 python -u 脚本，实时打印后汇总所有行。

Python 如何让 subprocess 捕获输出时同时保留实时打印 第1张

用 subprocess 执行命令时，既要实时看到输出（比如进度条、日志），又要最终拿到全部输出内容，关键在于不阻塞读取、及时刷出、避免缓冲干扰。

用 subprocess.Popen 配合 stdout=PIPE 和非阻塞/逐行读取

不能直接用 run(..., capture_output=True)，因为它会等命令结束才返回，无法实时打印。需手动管理进程和流：

  • 设置 stdout=subprocess.PIPE, stderr=subprocess.STDOUT（合并错误流便于统一处理）
  • 使用 text=True 直接获得字符串而非字节
  • 用 iter(proc.stdout.readline, '') 逐行读取，确保实时性
  • 每读到一行就立刻 print()，再存入列表或字符串

注意 Python 和子进程的输出缓冲问题

很多程序（如 python -c "print('x'); time.sleep(1)"）默认行缓冲或全缓冲，导致不换行就不输出。解决方法：

  • 对 Python 子进程加 -u 参数强制无缓冲：python -u script.py
  • 对 C/C++ 等程序，可用 stdbuf -oL -eL 行缓冲启动：stdbuf -oL -eL your_cmd
  • 避免用 print("msg", end="") 不换行；实时场景尽量每条日志都带 \n

完整可运行示例

以下代码执行一个模拟长任务的命令，实时打印每行，同时收集全部输出：

立即学习“Python免费学习笔记（深入）”；

import subprocess

cmd = ["python", "-u", "-c", "for i in range(3): print(f'正在处理 {i}...'); import time; time.sleep(1)"]
proc = subprocess.Popen(
cmd,
stdout=subprocess.PIPE,
stderr=subprocess.STDOUT,
text=True,
bufsize=1  # 行缓冲
)
output_lines = []
for line in iter(proc.stdout.readline, ''):
line = line.rstrip('\n')
print(f"[实时] {line}")  # 实时打印
output_lines.append(line)
proc.wait()  # 等待结束
full_output = '\n'.join(output_lines)
print(f"\n【汇总】共 {len(output_lines)} 行：{full_output}")

进阶：支持超时与异常处理

实际使用中建议加上超时和错误捕获：

  • 用 proc.wait(timeout=30) 防止卡死
  • 捕获 subprocess.TimeoutExpired 并调用 proc.kill()
  • 检查 proc.returncode != 0 判断是否执行失败
  • 若需兼容 Windows，注意 stderr=subprocess.STDOUT 在某些旧版本可能不生效，可改用分别处理 stdout 和 stderr 流