调用matplotlib.pyplot新建图时Tkinter多线程报main thread is not in main loop如何解决

• Tkinter本身是线程不安全的库，官方要求所有GUI相关操作（包括窗口创建、组件渲染、BooleanVar/StringVar等绑定变量的初始化、事件回调执行）都必须在同一个线程执行，且通常要求该线程是程序主线程。你当前把Tkinter主界面和主循环放在子线程运行本身就不符合规范，未调用matplotlib时只是没有触发线程冲突的边界条件，所以暂时没有报错。
• 当你在主线程调用plt.subplots()时，matplotlib的默认渲染后端如果是TkAgg（绑定Tkinter的后端），会自动在主线程初始化Tk上下文环境，此时你子线程中创建BooleanVar这类绑定变量时，Tkinter的底层检测到主线程运行的不是子线程内创建的Tk实例的主循环，就会抛出main thread is not in main loop错误。

方案1（最推荐）：调整线程归属，符合Tkinter设计规范 #

把Tkinter的所有操作放回主线程执行，业务逻辑、计算等耗时任务放到子线程运行。示例代码框架如下：

import tkinter as tk
import threading
import matplotlib.pyplot as plt

class App:
    def __init__(self, root):
        self.root = root
        # 所有GUI操作都在主线程初始化
        l1= tk.Label(self.root, text="label 1", fg="white", bg='gray')
        l1.grid(column=0, row=0, columnspan=2)

        self.c1v = tk.BooleanVar() 
        self.c1v.set(True)
        c1 = tk.Checkbutton(self.root, text='checkbox 1', var=self.c1v, command=self.callback, anchor="w")
        c1.grid(sticky="W", column=0, row=1)
        
        # 耗时任务放到子线程执行
        threading.Thread(target=self.plot_task, daemon=True).start()

    def callback(self):
        # 回调逻辑也在主线程运行
        print(self.c1v.get())
    
    def plot_task(self):
        # 子线程只做绘图计算相关逻辑
        fig, ax = plt.subplots(nrows=1, ncols=1, figsize=(4, 4), subplot_kw=dict(polar=True))
        # 绘图完成后如果要更新界面，用root.after调度到主线程执行
        self.root.after(0, lambda: print("绘图完成"))

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

方案2：修改matplotlib后端，避免和Tkinter上下文冲突 #

如果你坚持要把Tkinter放在子线程运行，可以在导入pyplot前指定matplotlib使用非Tk系的后端，避免它在主线程初始化Tk上下文：

import matplotlib
# 必须在import plt之前设置，指定不需要绑定Tk的后端
matplotlib.use('Agg')
import tkinter as tk
import threading
import matplotlib.pyplot as plt

# 后续原有App类代码不变，主线程调用plt.subplots也不会触发冲突

注意该方案下matplotlib的绘图无法直接弹出GUI窗口显示，仅适合生成图片文件保存的场景。

方案3：保证所有Tk相关操作都在同一个子线程执行 #

如果既要保留Tk在子线程的结构，又要使用matplotlib的Tk后端，需要确保所有和Tk相关的操作（包括matplotlib的GUI绘图相关操作）都放到你创建的App子线程内执行，主线程不要调用任何会触发Tk上下文初始化的代码，plt.subplots的调用也移动到App子线程的run方法里执行即可。

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