本文详解如何在 CustomTkinter（或标准 Tkinter）GUI 中安全、稳定地嵌入多个独立的 Matplotlib 动画图表，避免因 FuncAnimation 生命周期管理不当导致的空白图表、重复窗口及 UserWarning: Animation was deleted without rendering anything 错误。

本文详解如何在 customtkinter（或标准 tkinter）gui 中安全、稳定地嵌入多个独立的 matplotlib 动画图表，避免因 `funcanimation` 生命周期管理不当导致的空白图表、重复窗口及 `userwarning: animation was deleted without rendering anything` 错误。

在基于 Tkinter 的桌面应用中集成实时动态图表时，一个常见陷阱是：将 FuncAnimation 创建与 plt.show() 混用于嵌入式环境。Matplotlib 的 plt.show() 会启动独立的 GUI 事件循环（如 TkAgg 主窗口），与 Tkinter 主循环冲突，导致图表未渲染、空白窗口弹出，甚至引发动画对象被意外垃圾回收——这正是报错 Animation was deleted without rendering anything 的根本原因。

关键原则是：在嵌入式场景（如 FigureCanvasTkAgg）中，绝不可调用 plt.show()；动画必须绑定到已嵌入的 Figure 实例，并由 Tkinter 主循环驱动更新。

以下是经过验证的正确实现方案：

✅ 正确做法：动画绑定到嵌入 Figure，延迟初始化 Canvas

将动画逻辑封装为独立函数（而非类方法），并在按钮点击时按需创建 Figure、Axes、Animation 及 Canvas，确保每个动画拥有专属的 Figure 实例，且 FuncAnimation 对象被显式持有（防止 GC 回收）：

def primarygraphdata(primaryview, PRIMARYDATASOURCE):
    import matplotlib.pyplot as plt
    from matplotlib.animation import FuncAnimation
    from matplotlib.backends.backend_tkagg import FigureCanvasTkAgg
    import pandas as pd

    plt.style.use("dark_background")
    plt.rcParams["figure.figsize"] = (16, 10)

    # 1. 创建专属 Figure 和 Axes（不复用全局 plt.gcf()）
    primaryfig, primaryaxs = plt.subplots(2, 2, figsize=(10, 8))
    primaryfig.suptitle("Primary Mission Graphs", fontsize=14, color="white")
    primaryfig.set_facecolor("#2b2b2b")

    # 设置子图标题与样式
    primaryaxs[0, 0].set_title("Time vs Temperature", color="orange")
    primaryaxs[0, 1].set_title("Time vs Pressure", color="green")
    primaryaxs[1, 0].set_title("Altitude vs Temperature", color="blue")
    primaryaxs[1, 1].set_title("Time vs Altitude", color="cyan")

    # 2. 定义动画回调（闭包捕获 primaryfig & primaryaxs）
    def primaryanimate(i):
        try:
            data = pd.read_csv(PRIMARYDATASOURCE)
            time = data["Time"]
            temp = data["Temperature"]
            press = data["Pressure"]
            alt = data["Altitude"]

            # 清空各子图（非 plt.cla()！避免清空整个 figure）
            for ax in primaryaxs.flat:
                ax.clear()

            # 重绘数据
            primaryaxs[0, 0].plot(time, temp, "tab:orange", linewidth=1.5)
            primaryaxs[0, 1].plot(time, press, "tab:green", linewidth=1.5)
            primaryaxs[1, 0].plot(alt, temp, "tab:blue", linewidth=1.5)
            primaryaxs[1, 1].plot(time, alt, "tab:cyan", linewidth=1.5)

            # 可选：自动调整布局
            primaryfig.tight_layout()
        except Exception as e:
            print(f"[Primary Animation Error]: {e}")

    # 3. 创建动画对象 → 绑定到 primaryfig（非 plt.gcf()！）
    aniprimary = FuncAnimation(
        primaryfig,
        func=primaryanimate,
        interval=500,
        frames=50,
        cache_frame_data=False,  # 减少内存占用（Matplotlib ≥3.7）
        blit=False               # 若启用 blit，需手动处理 artists，初学者建议设为 False
    )

    # 4. 创建并嵌入 Canvas（关键：此时才实例化，且强引用 aniprimary）
    canvas_primary = FigureCanvasTkAgg(primaryfig, primaryview)
    canvas_primary.draw()
    canvas_primary.get_tk_widget().grid(row=0, column=0, sticky="nsew")

    # ⚠️ 至关重要：将动画对象赋值给 widget 属性，防止被 GC 回收
    primaryview._aniprimary = aniprimary
    primaryview._canvas_primary = canvas_primary

同理，secondarygraphdata() 函数也应遵循完全一致的模式，仅替换数据源、Axes 配置和绘图逻辑。

? 在主 App 类中调用（推荐解耦设计）

class App(ctk.CTk):
    def __init__(self) -> None:
        super().__init__()
        self.geometry("1100x580")
        self.tabview = ctk.CTkTabview(self, width=1080, height=570)
        self.tabview.pack(padx=10, pady=10)

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

        # 按钮绑定（传入对应 tab 视图和数据路径）
        ctk.CTkButton(
            self.tabview.tab("Live Primary Mission Graphs"),
            text="Start Primary Mission Graphs",
            command=lambda: primarygraphdata(
                self.tabview.tab("Live Primary Mission Graphs"),
                "data.csv"
            )
        ).place(x=850, y=190)

        ctk.CTkButton(
            self.tabview.tab("Live Secondary Mission Graphs"),
            text="Start Secondary Mission Graphs",
            command=lambda: secondarygraphdata(
                self.tabview.tab("Live Secondary Mission Graphs"),
                "data2.csv"
            )
        ).place(x=850, y=190)

⚠️ 关键注意事项总结

• 禁止使用 plt.gcf() 或 plt.show()：嵌入式动画必须显式传入 Figure 实例（如 FuncAnimation(primaryfig, ...)）。
• 动画对象必须被持久引用：将其赋值给 widget（如 tabview._aniprimary）或 self 属性，否则 Python GC 会在函数返回后立即销毁它。
• 避免 plt.cla() 全局清空：应调用 ax.clear() 清空单个子图，防止跨子图干扰。
• cache_frame_data=False 是推荐选项：尤其在数据量较大或帧数较多时，可显著降低内存峰值（适用于 Matplotlib ≥3.7）。
• 资源清理（进阶）：若需支持“停止动画”功能，应在 tabview 中保存 aniprimary.event_source.stop() 接口，并提供对应按钮。

通过以上结构化设计，你将获得稳定、可扩展、无警告的多动画嵌入体验——每个图表完全独立运行，互不干扰，真正契合生产级 Tkinter + Matplotlib 应用开发规范。