Matplotlib开启blit=True时动画逐帧进退及暂停功能异常如何解决

安全阿岳

2026-9-24

问题根因

开启blit=True时，Matplotlib的FuncAnimation要求更新函数必须返回可迭代的Artist对象序列，原代码update_plot直接返回单个Text对象，不符合要求触发类型错误
手动触发帧更新时直接调用plt.draw()，未适配blit模式的渲染逻辑，导致手动更新和动画渲染逻辑不一致

具体修改点

修改update_plot的返回值，将单个txt改为元组(txt,)，满足blit对可迭代返回值的要求
手动按键更新帧时，替换plt.draw()为blit渲染逻辑：先恢复背景缓存，再重绘修改后的Artist对象，最后刷新画布
新增save_count参数避免生成器类型的帧序列出现缓存溢出问题

完整可运行代码

import matplotlib.pyplot as plt
import matplotlib.animation as ani

fig, ax = plt.subplots()
txt = fig.text(0.5, 0.5, '0', fontsize=30)

def update_time():
    t = 0
    while True:
        t += anim.direction
        yield t

def update_plot(t):
    txt.set_text('%s' % t)
    # 修改返回值为可迭代元组
    return (txt,)

def on_press(event):
    if event.key.isspace():
        if anim.running:
            anim.event_source.stop()
        else:
            anim.event_source.start()
        anim.running ^= True
    elif event.key == 'left':
        anim.direction = -1
    elif event.key == 'right':
        anim.direction = +1

    # 手动更新适配blit模式
    if event.key in ['left', 'right']:
        t = anim.frame_seq.__next__()
        update_plot(t)
        fig.canvas.restore_region(anim._blit_cache['background'])
        fig.draw_artist(txt)
        fig.canvas.blit(fig.bbox)
        fig.canvas.flush_events()

fig.canvas.mpl_connect('key_press_event', on_press)
# 新增save_count参数
anim = ani.FuncAnimation(fig, update_plot, frames=update_time, interval=100, blit=True, save_count=100)
anim.running = True
anim.direction = +1
plt.show()