Matplotlib动画封装到函数后在Jupyter中无法渲染的问题求助

你遇到的问题核心来自两个关键点：

• 变量作用域错误：全局的animate函数无法访问generate_animation内部的line变量，导致动画无法更新数据
• 动画对象引用丢失：加上plt.show()的时机干扰，导致动画对象被垃圾回收，触发警告

修复方案一：嵌套动画更新函数 #

将animate函数嵌套在generate_animation内部，让它能直接访问函数内的line变量，同时移除多余的plt.show()，直接返回动画对象：

import matplotlib.pyplot as plt
import matplotlib.animation
import numpy as np

plt.rcParams["animation.html"] = "jshtml"
plt.rcParams["figure.dpi"] = 100
plt.ioff()

def generate_animation():
    # 嵌套animate函数，直接访问内部的line变量
    def animate(frame_num):
        x = np.linspace(0, 2*np.pi, 100)
        y = np.sin(x + 2*np.pi * frame_num/100)
        line.set_data((x, y))
        return line
    
    fig, ax = plt.subplots()
    line, = ax.plot([])
    ax.set_xlim(0, 2*np.pi)
    ax.set_ylim(-1.1, 1.1)

    anim = matplotlib.animation.FuncAnimation(
        fig, animate, frames=10, blit=True
    )
    
    # 直接返回动画对象，Jupyter会自动渲染
    return anim

# 保持对动画对象的引用，避免被垃圾回收
anim = generate_animation()
anim  # 在Jupyter单元格中执行此行即可显示动画

修复方案二：绑定参数到全局更新函数 #

如果不想嵌套函数，可以用functools.partial把line变量绑定到animate函数的参数中：

import matplotlib.pyplot as plt
import matplotlib.animation
import numpy as np
from functools import partial

plt.rcParams["animation.html"] = "jshtml"
plt.rcParams["figure.dpi"] = 100
plt.ioff()

# 修改animate函数，添加line参数
def animate(frame_num, line):
    x = np.linspace(0, 2*np.pi, 100)
    y = np.sin(x + 2*np.pi * frame_num/100)
    line.set_data((x, y))
    return line
    
def generate_animation():
    fig, ax = plt.subplots()
    line, = ax.plot([])
    ax.set_xlim(0, 2*np.pi)
    ax.set_ylim(-1.1, 1.1)

    # 使用partial绑定line参数，让FuncAnimation能正确调用animate
    anim = matplotlib.animation.FuncAnimation(
        fig, partial(animate, line=line), frames=10, blit=True
    )
    
    return anim

anim = generate_animation()
anim

关键说明 #

1. 作用域问题：原代码中animate是全局函数，重构后line变成了generate_animation的局部变量，全局函数无法访问这个变量，导致动画更新失败、图形空白。
2. 引用保持：必须将动画对象赋值给全局变量（比如anim），避免函数执行完后动画对象被垃圾回收，这就是警告提示的核心原因。
3. Jupyter渲染逻辑：使用jshtml后端时，Jupyter会自动渲染返回的Animation对象，不需要调用plt.show()，调用反而会干扰渲染流程。

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