如何阻止Jupyter Notebook自动显示函数返回的Matplotlib图像？

问题根源 #

Jupyter Notebook 里的 matplotlib 默认启用了自动显示机制：当单元格执行完毕时，inline 后端（默认后端）会自动渲染并显示当前所有未被显式关闭的活跃 figure 对象。

你写的函数里用 plt.figure() 创建了 figure，接着用 plt.plot() 基于这个全局活跃的 figure 绘图，函数返回后，这个 figure 仍然处于活跃状态，Jupyter 会自动检测到它并完成显示，这和常规脚本里必须调用 plt.show() 才显示的逻辑不一样。

解决方法 #

方法1：改用面向对象式绘图（推荐）

避免依赖 pyplot 的全局状态，直接操作 figure 和 axes 对象，精准控制显示时机：

def return_fig():
    fig, ax = plt.subplots()  # 直接创建figure和axes对象
    ax.plot([1,2,3,4,5],[1,2,3,4,5])  # 用axes对象绘图
    plt.close(fig)  # 关闭figure，阻止Jupyter自动显示
    return fig

后续需要显示时调用：

figure = return_fig()
plt.show(figure)  # 手动指定显示该figure

方法2：关闭matplotlib的交互式自动显示

在 notebook 开头执行以下代码，关闭全局自动显示设置：

import matplotlib.pyplot as plt
plt.ioff()  # 关闭交互式自动显示

之后执行原函数，figure 对象不会自动显示，需要手动调用 plt.show(figure) 来显示。

方法3：临时抑制单元格自动显示

在执行赋值的单元格末尾添加非 figure 输出，让 Jupyter 优先输出该内容，从而跳过自动显示：

figure = return_fig()
print("")  # 阻止Jupyter自动渲染figure

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