Python程序输出重定向至Tkinter独立窗口的问题及解决

问题描述 #

刚完成一学期Python课程，编程经验尚浅。希望将课程编写的现有程序输出全部重定向到独立Tkinter窗口，而非终端。按照教程实现重定向代码后，两个程序单独运行正常，但合在一起无法联动：原程序包含用户输入，导致必须在终端执行完整个main()函数后，Tkinter窗口才会打开，且窗口始终空白。

原实现代码 #

重定向GUI代码 #

import tkinter as tk
from tkinter import scrolledtext
import sys
import io

class TextWidgetStream(io.TextIOBase):
    def __init__(self, text_widget, tag="stdout"):
        super().__init__()
        self.text_widget = text_widget
        self.tag = tag  # Tag for coloring

    def write(self, s):
        self.text_widget.after(0, self._insert_text, s)

    def _insert_text(self, s):
        self.text_widget.config(state='normal')
        self.text_widget.insert('end', s, (self.tag,))
        self.text_widget.see('end') #Auto-scroll to bottom
        self.text_widget.config(state='disabled')

    def flush(self):
        pass #Required for stream compliance

class OutputRedirectorGUI:
    def __init__(self, root):
        self.root = root
        self.root.title("Title")
        self.root.geometry("800x600")

        #Save original Streams
        self.original_stdout = sys.stdout
        self.original_stderr = sys.stderr

        #Create and configure Text widget w/ scrollbar
        self.text_widget = scrolledtext.ScrolledText(
            root,
            wrap=tk.WORD,
            state=tk.DISABLED,
            bg="#020501",
            font=("Good Old DOS", 15)
        )
        self.text_widget.pack(padx=10, pady=10, fill = "both", expand=True)

        #Configure tags for stdout(black) & stderr (red)
        self.text_widget.tag_configure("stdout", foreground = "green4")
        self.text_widget.tag_configure("stderr", foreground = "red")

        # Redirect stdout and stderr:
        self.stdout_redirector = TextWidgetStream(self.text_widget, tag="stdout")
        self.stderr_redirector = TextWidgetStream(self.text_widget, tag="stderr")
        sys.stdout = self.stdout_redirector
        sys.stderr = self.stderr_redirector

        #Restore streams on exit
        self.root.protocol("WM_DELETE_WINDOW", self.on_exit)

    def on_exit(self):
        #Restore original streams before closing
        sys.stdout = self.original_stdout
        sys.stderr = self.original_stderr
        self.root.destroy()

原程序入口代码 #

if __name__ == "__main__":
    main()
    root = tk.Tk()
    app = OutputRedirectorGUI(root)
    root.mainloop()

问题根源 #

Tkinter的mainloop()是单线程的，而你先执行main()函数，其中的while循环和input()语句会完全阻塞主线程，直到整个main()执行完毕才会创建窗口并启动主循环。此时程序的所有输出已经打印到终端，重定向并未生效。

解决方案 #

使用多线程将main()函数放到独立线程中执行，让Tkinter主循环先启动并显示窗口，同时后台运行main()，确保输出能被实时重定向到窗口。另外补充了stdin的重定向处理（用于在窗口中展示输入内容）。

最终可用代码 #

import io
import tkinter as tk
import threading
from tkinter import ttk
from tkinter import scrolledtext
import sys

class TextWidgetStream(io.TextIOBase):
    def __init__(self, text_widget, tag="stdout"):
        super().__init__()
        self.text_widget = text_widget
        self.tag = tag  # Tag for coloring
    def write(self, s):
        self.text_widget.after(0, self._insert_text, s)
    def _insert_text(self, s):
        self.text_widget.config(state="normal")
        self.text_widget.insert("end", s, (self.tag,))
        self.text_widget.see("end")  # Auto-scroll to bottom
        self.text_widget.config(state="disabled")
    def flush(self):
        pass  # Required for stream compliance

def start_other_process(function_name):
    # 设置daemon=True，确保窗口关闭时线程自动终止
    p = threading.Thread(target=function_name, daemon=True)
    p.start()

original_stdout = sys.stdout
original_stdin = sys.stdin

# ----- Tkinter 窗口设置 -----
root = tk.Tk()
root.title("Title")
root.geometry("800x600")
# 框架/边框
custom_frame = tk.Frame(root)
custom_frame.pack(fill='x')
root.tk_setPalette(background='#020501')

# 带滚动条的文本组件
text_widget = scrolledtext.ScrolledText(
    root,
    wrap=tk.WORD,
    state=tk.DISABLED,
    bg="#020501",
    font=("Arial", 10)
)
text_widget.pack(padx=10, pady=10, fill = "both", expand = True)
text_widget.tag_configure("stdout", foreground="green4")
text_widget.tag_configure("stderr", foreground="red4")
text_widget.tag_configure("stdin", foreground="red")

# 重定向标准输出和输入
sys.stdout = TextWidgetStream(text_widget, "stdout")
sys.stdin = TextWidgetStream(text_widget, "stdin")

# 启动主循环100ms后，在新线程中运行main()
root.after(100, start_other_process, main)
root.mainloop()

# 恢复原始输出流
sys.stdout = original_stdout

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