Streamlit调用外部Python脚本实时输出延迟问题求助

核心问题分析 #

• 输出缓冲：Python默认在stdout重定向到管道时启用全缓冲，导致print内容不会实时输出，而是积累到一定量才一次性吐出，这就是你看到忽略time.sleep间隔、一次性输出的原因。
• Streamlit渲染机制：直接用st.write逐行输出时，Streamlit不会自动实时刷新页面，加上启动时的缓冲积累，就出现了30-40秒的延迟。

解决方案 #

方案1：修改调用命令，禁用Python输出缓冲

在调用外部脚本时添加-u参数，强制Python禁用stdout缓冲，同时用Streamlit占位符实时追加输出内容，优化渲染效率。

修改后的Streamlit代码：

import streamlit as st
import subprocess

start_button = st.button("Run External Script")

if start_button:
    # 使用-u参数禁用Python缓冲，script.py需添加引号
    command = ["python", "-u", "script.py"]
    process = subprocess.Popen(
        command,
        stdout=subprocess.PIPE,
        stderr=subprocess.STDOUT,
        universal_newlines=True,
        bufsize=1  # 设置行缓冲模式
    )
    
    # 创建占位符用于实时更新输出
    output_placeholder = st.empty()
    output_content = ""
    
    while process.poll() is None:
        line = process.stdout.readline()
        if line:
            output_content += line.strip() + "\n"
            # 更新占位符内容，用代码块格式更易读
            output_placeholder.markdown(f"```\n{output_content}\n```")
    
    # 处理脚本结束后剩余的输出
    remaining_output = process.stdout.read()
    if remaining_output:
        output_content += remaining_output.strip() + "\n"
        output_placeholder.markdown(f"```\n{output_content}\n```")

方案2：修改外部脚本，强制刷新输出

如果不想修改调用命令，可在script.py的print语句中添加flush=True参数，强制每次打印后刷新缓冲区：

修改后的script.py代码：

import time

print("Start", flush=True)
time.sleep(1)
print("Working", flush=True)
time.sleep(1)
print("Stop", flush=True)

此时Streamlit代码可保留原有逻辑，但仍建议用占位符优化渲染效果，避免多次st.write导致的页面卡顿。

关键说明 #

• -u参数是最便捷的方式，无需修改外部脚本，直接让Python以无缓冲模式运行。
• st.empty()占位符只会更新指定区域，相比多次st.write渲染效率更高，能实现真正的实时输出。
• 设置bufsize=1确保管道以行缓冲模式读取，配合-u可保证每行输出都被实时捕获。

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