Matplotlib图形重绘优化：合并子图参数的单函数实现

如果你在多次调用函数重绘Matplotlib图形时遇到轴属性（比如标题）无法修改、重复绘制导致字体模糊的问题，同时希望简化子图相关的参数结构，下面是完整的解决方案：

原代码的问题根源 #

最初的实现里重复创建fig, ax后又调用clf()、cla()，这种冗余操作要么让轴属性设置被覆盖失效，要么因为重复渲染导致字体模糊。后来的改进版解决了部分问题，但subplot_args和subplot_kw分开的参数设计不够简洁，统一参数结构能让代码更易维护。

优化后的实现：合并子图参数，高效重绘 #

我们可以将子图的位置参数和关键字参数合并为单个subplot_config参数，同时优化figure的复用逻辑，彻底解决重绘时的各种问题：

import matplotlib.pyplot as plt

def plot_func(xdata, ydata, figure_kw={}, subplot_config=None, axis_setters=None):
    # 设置子图配置的默认值：默认1行1列的第一个子图，无额外关键字参数
    default_subplot = {'args': (111,), 'kwargs': {}}
    subplot_config = subplot_config or default_subplot
    
    # 复用已存在的figure，避免重复创建导致的资源浪费和模糊
    fig_num = figure_kw.get('num')
    if fig_num is not None and plt.fignum_exists(fig_num):
        fig = plt.figure(fig_num)
        fig.clear()  # 彻底清空figure内的所有元素
    else:
        fig = plt.figure(**figure_kw)
    
    # 添加新的子图，使用合并后的配置参数
    ax = fig.add_subplot(*subplot_config['args'], **subplot_config['kwargs'])
    
    # 应用轴属性设置，确保每次重绘都能生效
    if axis_setters:
        for setter_name, setter_value in axis_setters.items():
            setter_func = getattr(ax, setter_name)
            setter_func(setter_value)
    
    # 绑定到当前轴绘制数据，避免上下文混乱
    ax.plot(xdata, ydata)
    
    return fig, ax

调用示例 #

基础使用（默认子图配置） #

plot_func([1,2,3], [1,2,3], figure_kw={'num': 'fixed_plot'}, axis_setters={'set_title': '固定标题'})

自定义子图布局与样式 #

# 配置2行1列的第2个子图，添加背景色
custom_subplot = {
    'args': (212,),
    'kwargs': {'facecolor': '#f5f5f5', 'ylabel': 'Y轴'}
}
plot_func(
    [1,2,3], 
    [3,1,2], 
    figure_kw={'num': 'custom_plot'}, 
    subplot_config=custom_subplot, 
    axis_setters={'set_title': '自定义子图标题'}
)

多次动态重绘场景 #

for i in range(50):
    plot_func(
        [1,2,3], 
        [i+1, i+2, i+3], 
        figure_kw={'num': 'dynamic_plot'}, 
        axis_setters={'set_title': f'动态更新：第{i+1}次绘制'}
    )
    plt.pause(0.1)  # 短暂暂停，方便观察动态效果

关键改进点 #

• 复用figure避免模糊：通过plt.fignum_exists()检查并复用已存在的figure，配合fig.clear()彻底清空旧内容，从根源解决重复绘制导致的字体模糊问题
• 统一子图参数结构：subplot_config将子图的位置参数（如(211,)）和关键字参数（如样式设置）整合到一个字典中，让函数参数更简洁，调用逻辑更清晰
• 轴属性可靠生效：每次重绘时创建新的轴并立即设置属性，不会被旧的轴状态覆盖，确保标题、标签等属性修改有效
• 明确的轴绑定：使用ax.plot()替代全局的plt.plot()，确保绘制操作精准作用于当前创建的轴，避免多轴场景下的绘制混乱

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