Matplotlib调用fig.clear()后Home按钮失效问题及求助

问题场景 #

在以下组合场景中，Matplotlib的Home、后退、前进导航按钮会失效：

• 通过plot.rcParams['toolbar'] = 'toolmanager'启用ToolManager（用于自定义工具栏）
• 交互式模式（plot.ion()）下调用fig.clear(keep_observers=True)重置画布后重新绘图

最小复现代码 #

import matplotlib.pyplot as plot
import numpy as np
plot.rcParams['toolbar'] = 'toolmanager' # 启用ToolManager
    
# 测试数据
x = np.linspace(0, 2 * np.pi, 1000)
y = np.cos(x)

fig = plot.figure()
ax = fig.add_subplot(1, 1, 1 )
ax.plot(x, y)
plot.ion()
plot.show()

# 此处暂停测试：缩放和Home功能正常
# pass 

fig.clear(keep_observers=True)

ax = fig.add_subplot(1, 1, 1 )
ax.plot(x, y)
plot.show()

# 此处暂停测试：缩放和Home/后退/前进功能失效
# pass 

问题原因 #

调用fig.clear()后，虽然通过keep_observers=True保留了事件观察者，但ToolManager关联的视图历史栈并未与新创建的Axes对象重新绑定，导致导航按钮无法获取或更新正确的视图状态。

解决方案 #

方案1：自定义导航工具替换默认工具 #

直接实现自定义的Home、后退、前进工具，手动维护视图历史并控制视图状态，这是最可靠的方式。

示例：自定义Home工具

from matplotlib.backend_tools import ToolBase

class CustomHomeTool(ToolBase):
    default_keymap = 'h'
    description = 'Reset to initial view'
    def trigger(self, *args, **kwargs):
        ax = self.figure.gca()
        # 重置到数据原生范围
        ax.relim()
        ax.autoscale_view()
        self.figure.canvas.draw_idle()

# 注册自定义工具到ToolManager
fig.canvas.manager.toolmanager.add_tool('CustomHome', CustomHomeTool)
# 替换工具栏上的默认Home按钮
fig.canvas.manager.toolbar.add_tool('CustomHome', 'navigation', 0)

类似地，可以实现后退/前进工具：维护一个视图历史栈，每次视图变化时记录xlim和ylim，触发后退/前进时恢复对应状态。

方案2：避免全局清空画布，改用Axes级重置 #

如果业务场景允许，不使用fig.clear()，而是逐个移除现有Axes再重新创建，同时手动初始化视图：

# 替代fig.clear()的代码
for ax in fig.axes:
    ax.remove()

# 重新创建Axes并绘图
ax = fig.add_subplot(111)
ax.plot(x, y)

# 手动初始化视图范围
ax.relim()
ax.autoscale_view()
fig.canvas.draw_idle()

注：这种方式在复杂交互场景下仍可能存在历史栈不同步问题，不如自定义工具稳定。

原提问者尝试后发现无理想原生解决方案，最终通过编写自定义导航工具替换默认工具，恢复了导航按钮的正常功能。

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