本文详解如何在 CustomTkinter（或标准 Tkinter）GUI 中正确嵌入并独立控制多个动态 Matplotlib 图表，避免因 plt.show() 干扰主事件循环、动画对象被意外回收及空白图形窗口等问题。

本文详解如何在 customtkinter（或标准 tkinter）gui 中正确嵌入并独立控制多个动态 matplotlib 图表，避免因 `plt.show()` 干扰主事件循环、动画对象被意外回收及空白图形窗口等问题。

在基于 Tkinter 的 GUI 应用中嵌入多个实时更新的 Matplotlib 动画图表时，一个常见但隐蔽的陷阱是：将 FuncAnimation 与 plt.show() 混用于嵌入式上下文。原始代码中，PrimaryGraphData 和 SecondaryGraphData 类各自在 plot_*_graphs() 方法内调用 plt.show()，这会阻塞 Tkinter 主循环、触发 Matplotlib 创建独立弹出窗口，并导致 FuncAnimation 实例在函数返回后被垃圾回收——从而引发警告：“Animation was deleted without rendering anything”。

根本原因在于：
✅ FigureCanvasTkAgg 要求动画绑定到已嵌入的 figure 实例（而非 plt.gcf()）；
❌ plt.show() 是面向“脚本式绘图”的阻塞式显示，与 GUI 嵌入模式互斥；
❌ 将 FuncAnimation 定义在类方法内且未保存为实例属性，使其作用域仅限于函数执行期，动画对象随即销毁。

✅ 正确做法：动画与 Canvas 绑定在同一作用域，显式持有引用

应将图表初始化、动画创建和 Canvas 嵌入封装为独立函数或方法，确保：

• FuncAnimation 显式传入目标 figure（非 plt.gcf()）；
• FigureCanvasTkAgg 在动画启动后立即挂载到 Tkinter 容器；
• 动画对象（FuncAnimation 实例）被强引用保留（如赋值给 self.ani 或局部变量），防止 GC 回收。

以下是重构后的推荐实现（适配 CustomTkinter + FigureCanvasTkAgg）：

import customtkinter as ctk
import matplotlib.pyplot as plt
from matplotlib.animation import FuncAnimation
from matplotlib.backends.backend_tkagg import FigureCanvasTkAgg
import pandas as pd

# 示例：独立函数式初始化（推荐用于模块化）
def setup_primary_animation(parent_frame: ctk.CTkFrame, data_source: str):
    plt.style.use("dark_background")
    fig, axs = plt.subplots(2, 2, figsize=(10, 8))
    fig.suptitle("Primary Mission Graphs", fontsize=14)
    fig.set_facecolor("#2b2b2b")

    # 设置子图标题
    axs[0, 0].set_title("Time vs Temperature")
    axs[0, 1].set_title("Time vs Pressure")
    axs[1, 0].set_title("Altitude vs Temperature")
    axs[1, 1].set_title("Time vs Altitude")

    def animate(i):
        try:
            data = pd.read_csv(data_source)
            time, temp = data["Time"], data["Temperature"]
            press, alt = data["Pressure"], data["Altitude"]

            # 清除旧图（注意：只清空 axes，不调用 plt.cla() 全局清除）
            for ax in axs.flat:
                ax.clear()

            axs[0, 0].plot(time, temp, "tab:orange", linewidth=1.2)
            axs[0, 1].plot(time, press, "tab:green", linewidth=1.2)
            axs[1, 0].plot(alt, temp, linewidth=1.2)
            axs[1, 1].plot(time, alt, "tab:blue", linewidth=1.2)
        except (FileNotFoundError, KeyError, pd.errors.EmptyDataError):
            pass  # 静默处理数据读取异常，避免中断动画

    # 关键：绑定到 fig（非 plt.gcf()），并禁用帧缓存以节省内存
    ani = FuncAnimation(fig, animate, interval=500, cache_frame_data=False)

    # 创建 Canvas 并嵌入
    canvas = FigureCanvasTkAgg(fig, parent_frame)
    canvas.draw()
    canvas.get_tk_widget().grid(row=0, column=0, sticky="nsew")

    # ⚠️ 必须保留 ani 引用！否则会被 GC 回收 → 报 Warning
    parent_frame.ani = ani  # 利用 CTkFrame 属性存储（或使用 self.ani 若在类中）

    return ani

# 在 App 类中调用（示例）
class App(ctk.CTk):
    def __init__(self):
        super().__init__()
        self.geometry("1100x580")
        self.title("Mission Data Dashboard")

        self.tabview = ctk.CTkTabview(self, width=1080, height=570)
        self.tabview.pack(padx=10, pady=10, fill="both", expand=True)

        self.tabview.add("Live Primary Mission Graphs")
        self.tabview.add("Live Secondary Mission Graphs")

        # 初始化按钮（不立即绘图）
        primary_btn = ctk.CTkButton(
            self.tabview.tab("Live Primary Mission Graphs"),
            text="Start Primary Mission Graphs",
            command=lambda: setup_primary_animation(
                self.tabview.tab("Live Primary Mission Graphs"), 
                "data.csv"
            )
        )
        primary_btn.grid(row=1, column=0, pady=10)

        secondary_btn = ctk.CTkButton(
            self.tabview.tab("Live Secondary Mission Graphs"),
            text="Start Secondary Mission Graphs",
            command=lambda: setup_secondary_animation(
                self.tabview.tab("Live Secondary Mission Graphs"), 
                "data2.csv"
            )
        )
        secondary_btn.grid(row=1, column=0, pady=10)

# 同理实现 setup_secondary_animation（结构一致，仅数据源与绘图逻辑不同）
def setup_secondary_animation(parent_frame: ctk.CTkFrame, data_source: str):
    fig, axs = plt.subplots(2, 2, figsize=(10, 8))
    fig.suptitle("Secondary Mission Graphs", fontsize=14)

    def animate(i):
        try:
            data = pd.read_csv(data_source)
            time, alt = data["Time"], data["Altitude"]
            tvoc, eco2 = data["TVOC"], data["eCO2"]
            h2, ethanol = data["H2"], data["Ethanol"]

            for ax in axs.flat:
                ax.clear()

            axs[0, 0].plot(time, tvoc, "tab:green")
            axs[0, 1].plot(alt, eco2, "tab:purple")
            axs[1, 0].plot(alt, h2)
            axs[1, 1].plot(time, ethanol, "tab:blue")
        except Exception:
            pass

    ani = FuncAnimation(fig, animate, interval=500, cache_frame_data=False)
    canvas = FigureCanvasTkAgg(fig, parent_frame)
    canvas.draw()
    canvas.get_tk_widget().grid(row=0, column=0, sticky="nsew")
    parent_frame.ani = ani  # 同样保留引用
    return ani

? 关键注意事项总结

• 禁止在嵌入式 GUI 中调用 plt.show()：它会接管控制权并破坏 Tkinter 事件循环；
• 动画必须绑定到具体 figure 实例：FuncAnimation(fig, ...)，而非 plt.gcf()（后者可能指向错误或临时 figure）；
• 显式持有 FuncAnimation 引用：将其赋值给长期存活的对象属性（如 frame.ani 或 self.ani），否则 Python GC 会在函数退出后立即销毁动画；
• 避免 plt.cla() 全局清除：改用 ax.clear() 精准控制子图，防止布局重置或坐标轴丢失；
• 异常防护必不可少：CSV 读取、列名缺失等均可能导致动画崩溃，务必用 try/except 包裹核心绘图逻辑；
• cache_frame_data=False 推荐启用：对实时流式数据可显著降低内存占用（Matplotlib 3.7+ 默认为 True）。

通过以上重构，你可稳定地在单个 Tkinter 窗口中并行运行多个独立动画图表，每个图表响应各自按钮触发、互不干扰，彻底规避空白窗口与动画失效问题。