运行外部脚本实时输出至tkinter Text组件报错，求排查与解决方案

1. 子线程直接操作GUI组件：tkinter严格要求GUI操作必须在主线程执行，子线程中调用textbox.insert()会触发异常。
2. 无限递归导致栈溢出：异常信息会被输出到重定向后的sys.stdout（即自定义的Redirect实例），而Redirect.write()方法又会调用textbox.insert()，再次触发异常，形成无限循环，最终耗尽栈空间。
3. 方法参数命名错误：Redirect.write()方法的参数应为输出文本，却被命名为textbox，造成语义混淆，虽非直接报错原因，但不符合标准接口规范。

核心思路 #

• 禁止子线程直接操作GUI，通过tkinter的after()方法将GUI操作切换到主线程执行；
• 简化外部脚本输出逻辑，直接将子进程的stdout重定向到已替换的sys.stdout，无需手动读取输出；
• 修正Redirect类的方法参数，符合标准stdout接口。

修正后的完整代码 #

example_gui.py

import tkinter as tk
import subprocess
import threading
import sys


class Redirect:
    def __init__(self, widget, autoscroll=True):
        self.widget = widget
        self.autoscroll = autoscroll

    def write(self, text):
        # 通过after在主线程执行插入操作，避免子线程操作GUI
        self.widget.after(0, self._insert_text, text)

    def _insert_text(self, text):
        self.widget.insert('end', text)
        if self.autoscroll:
            self.widget.see('end')

    def flush(self):
        pass


def run():
    # 启动子线程执行外部脚本
    threading.Thread(target=test, daemon=True).start()


def test():
    # 调用外部脚本，将stdout重定向到已替换的sys.stdout
    subprocess.Popen(
        ["python3", "demo_print.py"],
        stdout=sys.stdout,
        stderr=sys.stderr,  # 可选：同时重定向错误输出
        bufsize=1,
        text=True
    )


if __name__ == "__main__":
    fenster = tk.Tk()
    fenster.title("My Program")

    textbox = tk.Text(fenster)
    textbox.grid(row=0, column=0, sticky="nsew")

    scrollbar = tk.Scrollbar(fenster, orient=tk.VERTICAL, command=textbox.yview)
    scrollbar.grid(row=0, column=1, sticky="ns")
    textbox.config(yscrollcommand=scrollbar.set)

    # 调整布局，让文本框自适应窗口大小
    fenster.grid_rowconfigure(0, weight=1)
    fenster.grid_columnconfigure(0, weight=1)

    start_button = tk.Button(fenster, text="Start", command=run)
    start_button.grid(row=1, column=0, columnspan=2, pady=5)

    # 重定向stdout和stderr到Text组件
    old_stdout = sys.stdout
    sys.stdout = Redirect(textbox)
    old_stderr = sys.stderr
    sys.stderr = Redirect(textbox)

    fenster.mainloop()

    # 恢复标准输出流
    sys.stdout = old_stdout
    sys.stderr = old_stderr

demo_print.py保持不变：

import time
for i in range(10):
    print(f"print {i}")
    time.sleep(1)

通过队列在子线程和主线程之间传递输出内容，无需重定向sys.stdout，逻辑更直观：

import tkinter as tk
import subprocess
import threading
import queue


def read_output(output_queue, process):
    # 子线程读取外部脚本输出，存入队列
    for line in iter(process.stdout.readline, ''):
        output_queue.put(line)
    process.stdout.close()
    output_queue.put(None)  # 标记输出结束


def update_textbox(textbox, output_queue):
    # 主线程轮询队列，更新文本框内容
    while not output_queue.empty():
        line = output_queue.get()
        if line is None:
            return
        textbox.insert('end', line)
        textbox.see('end')
    # 每隔100ms继续轮询
    textbox.after(100, update_textbox, textbox, output_queue)


def run(textbox):
    output_queue = queue.Queue()
    process = subprocess.Popen(
        ["python3", "demo_print.py"],
        stdout=subprocess.PIPE,
        stderr=subprocess.STDOUT,  # 将错误输出合并到标准输出
        bufsize=1,
        text=True
    )
    # 启动子线程读取输出
    threading.Thread(target=read_output, args=(output_queue, process), daemon=True).start()
    # 启动主线程更新GUI
    update_textbox(textbox, output_queue)


if __name__ == "__main__":
    fenster = tk.Tk()
    fenster.title("My Program")

    textbox = tk.Text(fenster)
    textbox.grid(row=0, column=0, sticky="nsew")

    scrollbar = tk.Scrollbar(fenster, orient=tk.VERTICAL, command=textbox.yview)
    scrollbar.grid(row=0, column=1, sticky="ns")
    textbox.config(yscrollcommand=scrollbar.set)

    fenster.grid_rowconfigure(0, weight=1)
    fenster.grid_columnconfigure(0, weight=1)

    start_button = tk.Button(fenster, text="Start", command=lambda: run(textbox))
    start_button.grid(row=1, column=0, columnspan=2, pady=5)

    fenster.mainloop()

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