点击Canvas触发AttributeError: 'NoneType'无'canvas'属性的修复咨询

错误成因 #

这个AttributeError: 'NoneType' object has no attribute 'canvas'本质是mplcursors绑定的Matplotlib元素（比如轴对象）关联的画布实例已经变成了None。常见触发场景：

• 画布对象是局部变量，初始化后没被类属性或全局变量持有，被Python垃圾回收机制回收
• 在画布还没添加到PyQt6窗口布局、完成初始化前，就提前绑定了mplcursors
• 运行时随意销毁或重新赋值画布/figure对象，导致mplcursors内部的引用失效

是否需要额外添加鼠标点击事件？ #

完全不需要。mplcursors本身已经封装了鼠标点击、悬停等交互逻辑，额外添加自定义点击事件反而可能和mplcursors的事件处理流程冲突，引发更多问题。

最优修复方案 #

核心思路是保证mplcursors绑定的画布/轴对象生命周期和PyQt6窗口一致，且在画布完全初始化后再绑定cursor。

具体修复步骤 #

1. 将Matplotlib的Figure和FigureCanvasQTAgg实例设为类属性，避免因局部变量被回收导致引用丢失
2. 先把画布添加到PyQt6的布局中，完成初始化后再绑定mplcursors
3. 不要在运行时随意销毁或重新赋值这些绘图相关对象

修复前后代码对比 #

错误示例代码（触发问题）

import sys
from PyQt6.QtWidgets import QApplication, QMainWindow, QVBoxLayout, QWidget
from matplotlib.backends.backend_qtagg import FigureCanvasQTAgg as FigureCanvas
from matplotlib.figure import Figure
import mplcursors

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("Matplotlib + PyQt6")
        self.central_widget = QWidget()
        self.setCentralWidget(self.central_widget)
        self.layout = QVBoxLayout(self.central_widget)
        
        # 画布是局部变量，后续可能被回收
        fig = Figure()
        ax = fig.add_subplot(111)
        ax.plot([1,2,3,4], [1,4,9,16])
        # 画布还没添加到布局就绑定cursor
        cursor = mplcursors.cursor(ax)
        
        canvas = FigureCanvas(fig)
        self.layout.addWidget(canvas)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec())

修复后代码

import sys
from PyQt6.QtWidgets import QApplication, QMainWindow, QVBoxLayout, QWidget
from matplotlib.backends.backend_qtagg import FigureCanvasQTAgg as FigureCanvas
from matplotlib.figure import Figure
import mplcursors

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("Matplotlib + PyQt6")
        self.central_widget = QWidget()
        self.setCentralWidget(self.central_widget)
        self.layout = QVBoxLayout(self.central_widget)
        
        # 1. 将figure和canvas设为类属性，保证生命周期
        self.fig = Figure()
        self.canvas = FigureCanvas(self.fig)
        self.layout.addWidget(self.canvas)
        
        # 2. 初始化绘图轴并绘制内容
        self.ax = self.fig.add_subplot(111)
        self.ax.plot([1,2,3,4], [1,4,9,16])
        
        # 3. 画布初始化完成后，再绑定mplcursors
        self.cursor = mplcursors.cursor(self.ax)
        
        # 可选：自定义点击时的提示文本
        @self.cursor.connect("add")
        def on_add(sel):
            sel.annotation.set_text(f"x={sel.target[0]:.2f}, y={sel.target[1]:.2f}")

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec())

报错栈信息解析 #

典型的报错栈如下：

AttributeError: 'NoneType' object has no attribute 'canvas'
  File "/path/to/mplcursors/_pick_info.py", line 45, in _get_canvas
    return artist.figure.canvas
  File "/path/to/mplcursors/_cursor.py", line 567, in _update_annotation
    canvas = _get_canvas(self._artists[0])
  File "/path/to/mplcursors/_cursor.py", line 623, in _on_click
    self._update_annotation(sel)

从栈信息可以看到，错误发生在mplcursors内部的_get_canvas函数——它试图获取绘图元素关联的画布，但该元素的figure已经变成了None，说明对应的画布对象已经被回收或销毁，这和我们前面分析的成因完全匹配。

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