如何自定义热图悬停显示内容并解决Python程序运行报错

我来帮你搞定这个问题！你的核心需求是让热图鼠标悬停时只显示元素数值，同时解决程序运行时的大量报错，咱们一步步拆解优化：

先排查报错根源 #

你代码里的plt.show()是主要报错诱因之一——因为你已经用FigureCanvasTkAgg把matplotlib图表嵌入到tkinter窗口里了，再调用plt.show()会触发matplotlib的独立窗口和tkinter窗口的冲突，直接去掉这行就能解决大部分报错。

另外，原代码里mapArr的初始化有点冗余，先创建了numpy零数组又直接赋值为普通列表，建议统一转成numpy数组，避免潜在的类型问题。

实现悬停仅显示数值 #

mplcursors.cursor(hover=True)默认会显示x、y坐标，咱们可以通过自定义格式化函数来修改悬停提示的内容，只返回当前热图元素的数值：

• 定义一个show_only_value函数，接收sel（选中对象）参数
• 从sel.target里获取对应的x、y索引，然后从热图数据里取出对应数值
• 返回只包含数值的字符串，替换默认的坐标+数值提示

完整优化后的代码 #

import tkinter as tk
from matplotlib.backends.backend_tkagg import FigureCanvasTkAgg
import numpy as np
import matplotlib.pyplot as plt
import mplcursors

root = tk.Tk()
root.title("Stage 2 GUI")
root.geometry("1270x590")

# 规范数据定义：转成numpy数组，避免冗余初始化
mapArr = np.array([
    [113, 62, 31, 63], 
    [50, 101, 72, 47], 
    [92, 10, 40, 12], 
    [83, 21, 128, 16]
])

figure, axis = plt.subplots(figsize=(8,7))
heatmap = axis.imshow(mapArr, cmap="gray", interpolation='nearest', vmin=0, vmax=128)

# 隐藏坐标轴
heatmap.axes.get_xaxis().set_visible(False)
heatmap.axes.get_yaxis().set_visible(False)

# 添加颜色条
cb = figure.colorbar(heatmap)

# 嵌入tkinter窗口
canvas = FigureCanvasTkAgg(figure, root)
canvas.get_tk_widget().place(x=-60,y=-60)
canvas.draw()  # 确保画布绘制

# 自定义悬停提示格式
def show_only_value(sel):
    # 获取当前点的x、y索引
    x, y = int(sel.target[0]), int(sel.target[1])
    # 取出对应数值（注意imshow的索引顺序是(y,x)）
    value = mapArr[y, x]
    # 返回只显示数值的提示文本
    sel.annotation.set_text(f"数值: {value}")

# 应用自定义格式的悬停光标，指定仅作用于热图元素
mplcursors.cursor(heatmap, hover=True).connect("add", show_only_value)

root.mainloop()

关键修改点说明 #

• 去掉了冲突的plt.show()，改用tkinter的root.mainloop()管理窗口生命周期
• 将mapArr转为numpy数组，让数据操作更规范
• 给mplcursors.cursor指定了目标元素heatmap（避免影响其他元素），并通过connect("add", show_only_value)绑定自定义格式化函数
• 注意imshow的索引顺序是(y, x)，所以取值时要用mapArr[y, x]

这样修改后，鼠标悬停热图元素时就只会显示对应的数值，同时也解决了运行时的报错问题。

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