Tkinter线程问题：使用线程后应用菜单仍冻结的排查与修复

使用threading处理耗时任务后，Run按钮仅在几秒内保持响应，随后整个应用冻结但线程仍在运行。期望实现：循环向Text组件插入文本时，可自由操作应用的其他按钮及界面。

原代码：

import threading
from tkinter import *
from tkinter import ttk


class SubExtractor:
    def __init__(self, root):
        self.root = root
        self._create_layout()

    def _create_layout(self):
        self.root.title("Sub Extractor")

        self._menu_bar()

        self.main_frame = ttk.Frame(self.root, padding=(5, 5, 5, 15))

        self._video_frame()
        self._progress_frame()
        self._output_frame()

        self.main_frame.grid()

    def _menu_bar(self):
        self.root.option_add('*tearOff', FALSE)

        menubar = Menu(self.root)
        self.root.config(menu=menubar)

        menu_file = Menu(menubar)
        menu_settings = Menu(menubar)

        menubar.add_cascade(menu=menu_file, label="File")
        menubar.add_cascade(menu=menu_settings, label="Settings")

        menu_file.add_command(label="Open", command=self._open_file)
        menu_file.add_command(label="Close", command=self._close_window)

        menu_settings.add_command(label="Language", command=self._language_settings)
        menu_settings.add_command(label="Extraction", command=self._extraction_settings)

    def _video_frame(self):
        video_frame = ttk.Frame(self.main_frame, borderwidth=2, relief="ridge", width=1000, height=600)
        video_frame.grid()

    def _progress_frame(self):
        progress_frame = ttk.Frame(self.main_frame)
        progress_frame.grid(row=1, sticky="W")

        self.run_button = ttk.Button(progress_frame, text="Run", command=self._run)
        self.run_button.grid(pady=10, padx=30)

        self.progress_bar = ttk.Progressbar(progress_frame, orient=HORIZONTAL, length=800, mode='determinate')
        self.progress_bar.grid(column=2, row=0)

    def _output_frame(self):
        output_frame = ttk.Frame(self.main_frame)
        output_frame.grid(row=2)

        self.text_output_widget = Text(output_frame, width=97, height=12, state="disabled")
        self.text_output_widget.grid()

        output_scroll = ttk.Scrollbar(output_frame, orient=VERTICAL, command=self.text_output_widget.yview)
        output_scroll.grid(column=1, row=0, sticky="N,S")

        self.text_output_widget.configure(yscrollcommand=output_scroll.set)

    def _close_window(self):
        self._stop_run()
        self.root.quit()

    def _stop_run(self):
        self.interrupt = True
        self.run_button.configure(text="Run", command=self._run)

    def _text_to_output(self, text):
        self.text_output_widget.configure(state="normal")
        self.text_output_widget.insert("end", f"{text}\n")
        self.text_output_widget.see("end")
        self.text_output_widget.configure(state="disabled")

    def long_running_method(self):
        num = 100000
        self.progress_bar.configure(maximum=num)
        for i in range(0, num):
            if self.interrupt:
                break
            self._text_to_output(f"Line {i} of {num}")
            self.progress_bar['value'] += 1
        self._stop_run()

    def _run(self):
        self.interrupt = False
        self.run_button.configure(text='Stop', command=self._stop_run)
        threading.Thread(target=self.long_running_method).start()


rt = Tk()
SubtitleExtractorGUI(rt)
rt.mainloop()

问题根源 #

Tkinter的GUI操作不是线程安全的，所有对组件的修改必须在主线程（执行mainloop()的线程）中进行。你的子线程long_running_method里直接调用_text_to_output修改Text组件、更新进度条，频繁的跨线程GUI操作会打乱Tkinter的事件循环，导致界面冻结。

修复方案 #

使用Tkinter的after()方法，将GUI更新任务委托给主线程执行。after()会在主线程的事件循环中调度任务执行，避免线程冲突。

修改要点 #

1. 子线程只负责耗时计算，不直接操作GUI组件
2. 通过self.root.after(0, 任务函数, 参数)将GUI更新任务交给主线程执行

修复后的完整代码 #

import threading
from tkinter import *
from tkinter import ttk


class SubExtractor:
    def __init__(self, root):
        self.root = root
        self._create_layout()

    def _create_layout(self):
        self.root.title("Sub Extractor")

        self._menu_bar()

        self.main_frame = ttk.Frame(self.root, padding=(5, 5, 5, 15))

        self._video_frame()
        self._progress_frame()
        self._output_frame()

        self.main_frame.grid()

    def _menu_bar(self):
        self.root.option_add('*tearOff', FALSE)

        menubar = Menu(self.root)
        self.root.config(menu=menubar)

        menu_file = Menu(menubar)
        menu_settings = Menu(menubar)

        menubar.add_cascade(menu=menu_file, label="File")
        menubar.add_cascade(menu=menu_settings, label="Settings")

        menu_file.add_command(label="Open", command=self._open_file)
        menu_file.add_command(label="Close", command=self._close_window)

        menu_settings.add_command(label="Language", command=self._language_settings)
        menu_settings.add_command(label="Extraction", command=self._extraction_settings)

    def _video_frame(self):
        video_frame = ttk.Frame(self.main_frame, borderwidth=2, relief="ridge", width=1000, height=600)
        video_frame.grid()

    def _progress_frame(self):
        progress_frame = ttk.Frame(self.main_frame)
        progress_frame.grid(row=1, sticky="W")

        self.run_button = ttk.Button(progress_frame, text="Run", command=self._run)
        self.run_button.grid(pady=10, padx=30)

        self.progress_bar = ttk.Progressbar(progress_frame, orient=HORIZONTAL, length=800, mode='determinate')
        self.progress_bar.grid(column=2, row=0)

    def _output_frame(self):
        output_frame = ttk.Frame(self.main_frame)
        output_frame.grid(row=2)

        self.text_output_widget = Text(output_frame, width=97, height=12, state="disabled")
        self.text_output_widget.grid()

        output_scroll = ttk.Scrollbar(output_frame, orient=VERTICAL, command=self.text_output_widget.yview)
        output_scroll.grid(column=1, row=0, sticky="N,S")

        self.text_output_widget.configure(yscrollcommand=output_scroll.set)

    def _close_window(self):
        self._stop_run()
        self.root.quit()

    def _stop_run(self):
        self.interrupt = True
        self.root.after(0, lambda: self.run_button.configure(text="Run", command=self._run))

    def _text_to_output(self, text):
        self.text_output_widget.configure(state="normal")
        self.text_output_widget.insert("end", f"{text}\n")
        self.text_output_widget.see("end")
        self.text_output_widget.configure(state="disabled")

    def _update_progress(self, value):
        self.progress_bar['value'] = value

    def long_running_method(self):
        num = 100000
        self.root.after(0, lambda: self.progress_bar.configure(maximum=num))
        for i in range(0, num):
            if self.interrupt:
                break
            self.root.after(0, self._text_to_output, f"Line {i} of {num}")
            self.root.after(0, self._update_progress, i+1)
        self.root.after(0, self._stop_run)

    def _run(self):
        self.interrupt = False
        self.root.after(0, lambda: self.run_button.configure(text='Stop', command=self._stop_run))
        threading.Thread(target=self.long_running_method, daemon=True).start()

    # 补充原代码未实现的空方法，避免报错
    def _open_file(self):
        pass

    def _language_settings(self):
        pass

    def _extraction_settings(self):
        pass


rt = Tk()
SubExtractor(rt)  # 修正原代码类名错误
rt.mainloop()

额外修复点 #

• 修正原代码实例化时的类名错误（SubtitleExtractorGUI改为SubExtractor）
• 给子线程添加daemon=True，确保关闭程序时线程自动退出
• 补充原代码未实现的空方法，避免运行时抛出异常

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