Matplotlib FuncAnimation多次调用init_func：是Bug还是特性？

先给你明确结论：这不是Bug，是Matplotlib的预期特性。下面给你拆解原因和解决方案：

为什么init_func会被多次调用？ #

按照文档描述，init_func确实是为第一帧提供初始状态的函数，但Matplotlib会在这些场景下额外调用它：

• 启用blit=True时，Matplotlib内部会先调用一次init_func来生成干净的初始缓冲区，之后在动画正式启动前再调用一次
• 当画布发生重绘事件时（比如窗口被最小化后恢复、调整窗口大小），init_func会被再次调用以重置画面状态
• 部分后端渲染逻辑也会触发init_func的重复调用

你在官网示例里看到两次Initializing输出，就是blit=True导致的初始化+首次渲染两次调用；动画运行中窗口变化时的重复调用，也是画布重绘的正常行为。

解决方案 #

根据你的使用场景，有几种靠谱的处理方式：

1. 用标志位控制仅执行一次核心逻辑 #

如果init_func里有只需要跑一次的操作（比如初始化数据、创建静态元素），可以加个全局或类内的标志位来跳过重复执行：

# 官网示例修改版
import numpy as np
import matplotlib.pyplot as plt
import matplotlib.animation as animation

fig, ax = plt.subplots()
x = np.arange(0, 2*np.pi, 0.01)
line, = ax.plot(x, np.sin(x))

initialized = False  # 初始化完成标志位

def animate(i):
    line.set_ydata(np.sin(x + i/10.0))
    return line,

def init():
    global initialized
    if not initialized:
        print('Initializing (only once!)')
        line.set_ydata(np.ma.array(x, mask=True))
        initialized = True
    return line,

ani = animation.FuncAnimation(fig, animate, np.arange(1, 200), init_func=init, interval=25, blit=True)
plt.show()

2. 类中把一次性初始化移到__init__方法 #

你在类里创建多线条的场景，完全可以把创建线条的逻辑放到类的构造函数里，init_func只负责重置线条状态（而非重复创建）：

class MyAnimation:
    def __init__(self, n):
        self.fig, self.ax = plt.subplots()
        self.n = n
        self.lines = []
        # 在这里完成线条创建，仅执行一次
        for i in range(self.n):
            line = self.ax.plot([], [])[0]
            self.lines.append(line)
    
    def run_animation(self):
        def animate(i):
            # 这里写每一帧的更新逻辑
            for idx, line in enumerate(self.lines):
                line.set_data([0, i], [0, idx*i])  # 示例更新逻辑
            return self.lines
        
        def init():
            # 只需要重置线条状态，不需要重复创建
            for line in self.lines:
                line.set_data([], [])
            return self.lines
        
        ani = animation.FuncAnimation(self.fig, animate, init_func=init, interval=25, blit=True)
        plt.show()

# 使用示例
anim = MyAnimation(3)
anim.run_animation()

3. 禁用blitting（不推荐，影响性能） #

如果对动画性能要求不高，可以设置blit=False，这样init_func只会在动画启动时调用一次，但画面刷新速度会变慢，尤其是元素较多时。

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