Python matplotlib绘图AttributeError报错及内存正确释放方法

报错根因说明 #

你遇到的两个报错都是接口调用方式错误导致的：

• 第一种方案错误点：
  • Figure对象的clear()方法会直接删除挂载在Figure上的所有Axes坐标轴实例，执行后Figure会变成无坐标轴的空壳，也就是你看到的<Figure size 1280x960 with 0 Axes>提示，只要clear之后有任何设置标题、调整坐标轴属性的操作，就会触发AttributeError: 'Figure' object has no attribute 'title'报错。
  • 释放内存不需要先手动执行clear，plt.close()本身就会销毁Figure及其绑定的所有子对象，提前clear属于多余操作反而容易触发异常。
• 第二种方案错误点：matplotlib.pyplot模块没有clear()这个顶层接口，对应清除画布的官方接口是plt.clf()（清除当前Figure内容）、plt.cla()（清除当前Axes内容），调用不存在的plt.clear()必然触发属性错误。

循环场景无内存泄漏的标准写法 #

优先推荐面向对象写法，完全避开pyplot全局状态机的隐式引用问题，跑上千次循环内存也不会持续上涨：

import matplotlib.pyplot as plt

# 遍历所有交易对执行回测
for symbol in trade_pairs:
    # 1. 显式创建Figure实例，绑定到变量
    backtest_fig = plt.figure(figsize=(16, 12), dpi=80)
    ax = backtest_fig.add_subplot(111)

    # 2. 所有绘图、配置操作绑定到显式创建的Axes/Figure对象
    ax.set_title(f"{symbol} Backtest Result")
    ax.plot(res_df["trade_date"], res_df["strategy_nav"], label="Strategy NAV")
    ax.plot(res_df["trade_date"], res_df["benchmark_nav"], label="Benchmark NAV")
    ax.legend()
    ax.grid(alpha=0.3)

    # 3. 保存绘图结果
    backtest_fig.savefig(f"{save_dir}/{symbol}.png", bbox_inches="tight")

    # 4. 直接关闭当前Figure，自动回收所有关联内存，不需要提前clear
    plt.close(backtest_fig)

    # 极端场景下可打开注释，强制触发垃圾回收，进一步避免内存残留
    # import gc
    # gc.collect()

如果你习惯用pyplot状态机接口写法，把释放逻辑改成正确接口即可：

import matplotlib.pyplot as plt

for symbol in trade_pairs:
    # 绘图配置流程
    plt.figure(figsize=(16, 12), dpi=80)
    plt.title(f"{symbol} Backtest Result")
    plt.plot(res_df["trade_date"], res_df["strategy_nav"], label="Strategy NAV")
    plt.plot(res_df["trade_date"], res_df["benchmark_nav"], label="Benchmark NAV")
    plt.legend()
    plt.grid(alpha=0.3)

    # 保存结果
    plt.savefig(f"{save_dir}/{symbol}.png", bbox_inches="tight")

    # 正确释放流程：先清画布内容，再关闭Figure
    plt.clf()
    plt.close()

避坑提示 #

• 不要在循环外提前创建Figure/Axes对象再循环内反复clear重用，尤其是每次绘图的子图数量、元素数量差异大的场景，隐式残留的引用很容易导致内存无法被GC回收。
• 如果用了pandas、seaborn等第三方库的plot接口，这些接口默认会在pyplot全局当前Figure上绘图，一定要在每次循环结束时显式关闭对应Figure，不要依赖Python自动回收机制。
• 不要在执行Figure.clear()后再对该Figure做任何配置、绘图操作，clear后所有Axes实例已经被销毁，后续操作必然报错。
• 按上述写法实现后，286个交易对的回测绘图场景下，内存会稳定在固定区间，不会随已保存图片数量增长持续升高。

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