Matplotlib动态增量添加子图后调用show无显示的原因与解决方法
问题核心原因
你对matplotlib.figure.Figure.add_subplot()的参数规则存在本质理解偏差,这是画布无内容渲染、布局错乱的根本原因:
add_subplot(nrows, ncols, index)三个参数的标准含义是:将整个Figure画布预先划分为「nrows行 × ncols列」的固定网格体系,再在对应网格的第index个位置放置子图。- 你之前的调用逻辑每次都在改动全局网格的行列总数:
- 第一次调用时,
ax1 = fig.add_subplot(1,1,1)会把整图划分为1行1列,ax1占满整图;紧接着ax2 = fig.add_subplot(1,2,2)又会把整图重新划分为1行2列,ax2被放在新网格的第2位。 - 第二次调用时,row_num更新为2,
ax1 = fig.add_subplot(2,1,1)重新把整图划分为2行1列,ax1放在第一行;紧接着ax2 = fig.add_subplot(2,2,2)又重新把整图划分为2行2列,ax2放在第二格。
- 第一次调用时,
- 这种每次重设全局网格参数的写法,会不断覆盖原有子图的网格占位关系,最终子图位置会和你预期完全不符,甚至会因为位置重叠、网格划分矛盾出现完全空白的渲染结果。
正确实现方案
要实现「每次调用追加一行、每行固定2列子图」的效果,不需要每次修改全局网格的划分规则,有两种可靠实现方式:
方案1:固定全局网格参数,通过索引匹配子图位置
只要从第一次调用开始,始终保持add_subplot的前两个参数固定为(支持的最大总行数, 2),通过第三个索引值精准匹配子图的放置位置即可。
2列网格下,第k行的两个子图对应的全局索引为:左列2*(k-1)+1、右列2*(k-1)+2。
调整后的plot_history核心逻辑如下:
import matplotlib.pyplot as plt from itertools import count # 从1开始逐次生成连续行号的生成器 row_num_generator = count(start=1) # 预先设定支持的最大总行数,比如最大支持100行,全程网格规则保持固定 MAX_SUPPORT_ROW = 100 def plot_history(fig: matplotlib.figure.Figure, hs: History): row_num = next(row_num_generator) # 固定前两个参数为全局网格的行列数,仅通过index匹配目标位置 ax1 = fig.add_subplot(MAX_SUPPORT_ROW, 2, 2*(row_num-1)+1) # 原有绘图逻辑保持不变 try: ax1.plot(hs.history['accuracy']) ax1.plot(hs.history['val_accuracy']) except KeyError: ax1.plot(hs.history['acc']) ax1.plot(hs.history['val_acc']) ax1.title.set_text('Accuracy vs. epochs') ax1.set_ylabel('Accuracy') ax1.set_xlabel('Epoch') ax1.legend(['Training', 'Validation'], loc='lower right') ax2 = fig.add_subplot(MAX_SUPPORT_ROW, 2, 2*(row_num-1)+2) # 原有绘图逻辑保持不变 ax2.title.set_text('Loss vs. epochs') ax2.plot(hs.history['loss']) ax2.plot(hs.history['val_loss']) ax2.set_ylabel('Loss') ax2.set_xlabel('Epoch') ax2.legend(['Training', 'Validation'], loc='upper right')
这种写法全程网格划分规则统一,子图位置不会因为参数修改出现冲突。
方案2:使用GridSpec实现无预设行数的动态追加
如果完全无法预先确定总行数,可以用动态GridSpec容器管理子图布局,不需要提前设定固定行数:
from matplotlib.gridspec import GridSpec import matplotlib.pyplot as plt # 初始化空Figure和空GridSpec容器 main_figure = plt.figure() gs = GridSpec(nrows=0, ncols=2, figure=main_figure) def plot_history(fig, gs, hs): # 每次调用时为GridSpec新增一行 gs._nrows += 1 current_row_idx = gs._nrows - 1 # 在当前行的两个列位上新增子图 ax1 = fig.add_subplot(gs[current_row_idx, 0]) ax2 = fig.add_subplot(gs[current_row_idx, 1]) # 后续绘图逻辑和原有实现保持一致即可
其他注意事项
- 不要直接调用
fig.show()作为最终渲染逻辑,这个方法仅在Matplotlib 3.3+版本的交互式后端下稳定可用,部分旧版本、非交互式后端会出现渲染无输出的问题,建议在代码最后统一调用全局plt.show()完成阻塞渲染。 - 原有代码存在一处笔误:绘制Accuracy曲线的ax1将Y轴标签设为了
'Loss',和展示的指标不匹配,调整为对应指标名即可。 - Matplotlib内部的子图管理器会记录最后一次的网格划分参数,后续所有新增子图都会按照最后一次的网格规则计算位置,禁止每次调用add_subplot时随意修改nrows、ncols参数。
内容的提问来源于stack exchange,提问作者Johnny Bonelli
相关产品推荐
相关产品推荐

