Matplotlib动画图表中如何在绘图区域外添加图形文本？

阿华AIGC实验室

2026-4-16

我太懂你这种挫败感了——静态图里好好待在绘图区域外的脚注、图例，一做成动画就直接消失，找半天原因都摸不着头脑对吧？其实核心问题出在Matplotlib动画的渲染逻辑上，咱们一步步来解决：

问题根源

Matplotlib的动画（尤其是用blit=True优化渲染时）默认只会更新轴域（Axes）内部的元素，对于超出轴范围的元素，如果没正确设置动画属性，就会被渲染过程当成“不需要保留”的内容给删掉。

解决步骤&修改后的代码

我把你的代码调整了关键部分，你可以参考：

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

def lineplot(df, savfyl, title, ylabel, xlabel = 'Year',legend = 'y', footnote = '' ):
    # 第一步：先给外部文本/图例预留显示空间，不然位置再对也看不到
    fig, ax = plt.subplots()
    plt.subplots_adjust(bottom=0.2)  # 底部边距调大，给脚注留位置，如果是图例在右边就加right=0.8
    
    limy = (min(df.min()),max(df.max()))
    # 第二步：设置脚注文本，位置固定，同时标记为非动画元素
    ftext = plt.figtext(0.15, -0.1, footnote, fontsize=8)  # y值稍微调整，确保在预留的边距里
    ftext.set_animated(False)  # 关键！告诉动画：这个元素不用你更新，一直留着

    def init():
        # 初始化函数里别乱改ftext的位置！保持初始设置就好
        ax.set_ylim(limy)
        ax.set_xlabel(xlabel)
        ax.set_ylabel(ylabel)
        ax.set_title(title)
        return ax,

    def update(frame):
        # 动画更新逻辑，比如逐列绘制数据
        ax.clear()
        ax.plot(df.iloc[:, :frame+1])
        # 因为clear()会清掉轴的属性，所以要重新设置
        ax.set_ylim(limy)
        ax.set_xlabel(xlabel)
        ax.set_ylabel(ylabel)
        ax.set_title(title)
        
        # 如果要加外部图例，同样处理
        if legend == 'y':
            leg = ax.legend(df.columns, bbox_to_anchor=(1.05, 1), loc='upper left')
            leg.set_animated(False)  # 图例也要标记为非动画元素
        return ax,

    # 注意blit=True是高效渲染的关键，配合set_animated(False)才能保留外部元素
    ani = animation.FuncAnimation(fig, update, frames=len(df.columns), init_func=init, blit=True)
    ani.save(savfyl, writer='ffmpeg')
    plt.show()

关键要点说明

预留边距：这是很多人容易忽略的点——就算动画不删你的文本，如果它在figure的默认边距外面，照样显示不出来。用plt.subplots_adjust()根据元素位置调整bottom/right/left/top的数值。
set_animated(False)：这个属性的作用是告诉动画渲染器：“这个元素是静态的，不用每次更新都重新画，也别把它删掉”。所有你想留在动画里的静态外部元素（脚注、图例、水印等）都要加这个设置。
init()和update()的注意事项：init()里不要随意修改外部元素的位置；update()里如果用了ax.clear()，记得重新设置轴的标签、标题，以及图例的animated属性，因为clear()会把轴内的元素都清掉。