如何在另一个线程中打开Tk窗口（解决Tcl跨单元调用错误）

错误原因 #

Tkinter是单线程GUI库，所有GUI相关操作必须在主线程执行。你在子线程中创建Tk()实例并调用tkinter.mainloop()，违反了Tkinter的线程安全规则，直接触发了“Calling Tcl from different apartment”错误。

核心解决方案 #

1. 用Toplevel替代Tk()创建新窗口：Toplevel是依附于主窗口的顶级窗口，共享主事件循环，无需单独启动mainloop。
2. 所有GUI操作留在主线程：如果有耗时的数据处理逻辑，将其放在子线程，处理完成后通过主线程的after()方法触发GUI更新。

修正后的代码示例 #

controller.py

移除子线程调用GUI的逻辑，直接在主线程触发新窗口创建：

# controller.py
def get_db(self, x, y):
    if self.model.df is None:
        self.show_error("请提供码头平面图。")
        return
    try:
        self.model.x = x
    except ValueError as error:
        self.show_error(error)
        return
    try:
        self.model.y = y
    except ValueError as error:
        self.show_error(error)
        return

    # 直接在主线程调用GUI方法，无需子线程
    self.view.show_map(self.model.df)
    self.view.reset()

map_button.py

修改窗口创建逻辑，使用Toplevel并移除独立的mainloop：

# map_button.py
import tkinter as tk
from tkinter import Frame, Grid

def display_map(parent, df):
    print(df.shape)
    # 创建依附于主窗口的顶级窗口，而非新的Tk实例
    root = tk.Toplevel(parent)
    root.title("地图窗口")
    frame = Frame(root)
    Grid.rowconfigure(root, 0, weight=1)
    Grid.columnconfigure(root, 0, weight=1)
    frame.grid(row=0, column=0, sticky="nsew")
    grid = Frame(frame)
    grid.grid(sticky="nsew", column=0, row=7, columnspan=2)
    Grid.rowconfigure(frame, 7, weight=1)
    Grid.columnconfigure(frame, 0, weight=1)

    w = display_map_as_button(df, frame, df.shape[1], df.shape[0])
    # 无需单独调用mainloop，主窗口的事件循环会处理新窗口的所有交互

处理耗时操作的进阶方案 #

如果display_map_as_button是耗时操作，为避免阻塞主窗口，可将数据处理放在子线程，完成后再通过主线程渲染GUI：

controller.py

# controller.py
import threading

def get_db(self, x, y):
    # ... 保留之前的校验逻辑 ...

    # 耗时操作放入子线程
    thread = threading.Thread(target=self._process_map_data, args=[self.model.df])
    thread.start()
    self.view.reset()

def _process_map_data(self, df):
    # 在这里执行耗时的数据处理
    w = display_map_as_button(df, df.shape[1], df.shape[0])
    # 通过after方法将GUI操作抛回主线程
    self.view.parent.after(0, self._render_map_window, df, w)

def _render_map_window(self, df, w):
    # 主线程中创建窗口并渲染控件
    display_map(self.view.parent, df, w)

map_button.py

调整display_map接收预处理后的w参数：

# map_button.py
def display_map(parent, df, w):
    print(df.shape)
    root = tk.Toplevel(parent)
    root.title("地图窗口")
    frame = Frame(root)
    Grid.rowconfigure(root, 0, weight=1)
    Grid.columnconfigure(root, 0, weight=1)
    frame.grid(row=0, column=0, sticky="nsew")
    grid = Frame(frame)
    grid.grid(sticky="nsew", column=0, row=7, columnspan=2)
    Grid.rowconfigure(frame, 7, weight=1)
    Grid.columnconfigure(frame, 0, weight=1)

    # 直接使用预处理好的w进行渲染
    # 根据实际逻辑将w添加到frame或grid中

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