如何在Tkinter中实现嵌套多线程？解决主线程不在主循环的RuntimeError

错误原因 #

Tkinter和CustomTkinter的所有GUI操作必须在主线程完成，子线程里创建窗口、修改控件都会触发RuntimeError: main thread is not in main loop。你代码里的splash_screen()在子线程创建了新的Tk实例，还调用了destroy()，这些GUI操作都违反了主线程独占GUI的规则，加上CustomTkinter的DPI缩放检测在主线程事件循环里运行，子线程创建的窗口会导致检测逻辑出错。

修正方案 #

核心思路：把所有GUI操作（启动屏的创建/销毁、顶级窗口打开）放回主线程，只把耗时的初始化逻辑放到子线程执行，子线程完成后通过主线程的after方法触发后续GUI操作。

修正后的代码 #

import customtkinter
import threading

def create_splash():
    # 用Toplevel做启动屏，不要创建新的Tk实例，避免多主循环冲突
    global splash
    splash = customtkinter.CTkToplevel(root)
    splash.title("加载中")
    # 禁止调整启动屏大小
    splash.resizable(False, False)
    # 让启动屏置顶
    splash.attributes("-topmost", True)
    
    label = customtkinter.CTkLabel(splash, text="PLEASE WAIT...")
    label.pack(pady=30, padx=30)
    
    # 让启动屏在根窗口中心
    root.update_idletasks()
    x = (root.winfo_width() // 2) + root.winfo_x() - (splash.winfo_width() // 2)
    y = (root.winfo_height() // 2) + root.winfo_y() - (splash.winfo_height() // 2)
    splash.geometry(f"+{x}+{y}")

def initiate():
    # 这里放耗时的初始化操作，比如加载数据、创建控件对象等
    # 模拟耗时操作，实际替换成你的逻辑
    import time
    time.sleep(3)
    
    # 初始化完成后，通知主线程关闭启动屏并打开顶级窗口
    root.after(0, finish_init)

def finish_init():
    # 主线程执行：关闭启动屏
    splash.destroy()
    # 打开顶级窗口
    open_toplevel()

def open_toplevel():
    top = customtkinter.CTkToplevel(root)
    top.title("顶级窗口")
    top.geometry("400x300")
    label = customtkinter.CTkLabel(top, text="初始化完成！")
    label.pack(pady=50)

def on_button_click():
    # 主线程创建启动屏
    create_splash()
    # 启动子线程执行初始化，不阻塞根窗口
    threading.Thread(target=initiate, daemon=True).start()

# 根窗口初始化
root = customtkinter.CTk()
root.title("主窗口")
root.geometry("500x400")

button = customtkinter.CTkButton(root, text="启动", command=on_button_click)
button.pack(pady=10, padx=10)

root.mainloop()

关键细节说明 #

• 启动屏用CTkToplevel：避免创建多个Tk实例，每个程序应该只有一个主Tk实例（这里就是root），Toplevel作为子窗口依附于主窗口，不会触发多主循环问题。
• 子线程只做耗时逻辑：initiate函数里只处理非GUI的初始化工作，比如加载数据、计算等，绝对不碰任何Tkinter/CustomTkinter控件。
• 用after回到主线程：子线程完成后，调用root.after(0, 回调函数)，把GUI操作（关闭启动屏、打开新窗口）交给主线程的事件循环处理，这是Tkinter中安全的跨线程GUI操作方式。
• daemon线程：设置daemon=True让子线程随主程序退出，避免程序关闭后还有残留线程。

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