使用matplotlib和pynput实时绘制鼠标移动时代码阻塞问题排查

哎，这个问题我之前也踩过坑！核心原因是Matplotlib的GUI操作完全不是线程安全的——你用pynput的鼠标监听器跑在独立线程里，直接在回调里调用ax.draw_artist这类Matplotlib API，相当于跨线程乱改Matplotlib的内部状态，不阻塞才怪呢。

为什么原代码会卡住？ #

pynput的mouse.Listener本质是个threading.Thread，所有回调（比如你的on_move）都在这个子线程里执行。但Matplotlib的画布渲染、blit这些操作，必须在主GUI线程里完成——跨线程调用这些方法会破坏Matplotlib的内部锁和状态，直接导致程序停滞或者崩溃。

怎么解决？ #

我们需要用线程安全的通信方式把鼠标坐标从监听线程传递到主线程，让主线程专门处理绘图。最直观的方式就是用queue模块，子线程只负责把坐标丢进队列，主线程循环读取队列并更新绘图。

修改后的代码如下：

import matplotlib.pyplot as plt
from pynput import mouse
from time import sleep
import queue

# 创建线程安全队列，用来传递鼠标坐标
coord_queue = queue.Queue()

fig, ax = plt.subplots()
ax.set_xlim(0, 1919)
ax.set_ylim(0, 1079)
plt.show(block=False)
plt.draw()
x, y = 0, 0
points = ax.plot(x, y, 'o')[0]

# 缓存背景，提升绘制效率
background = fig.canvas.copy_from_bbox(ax.bbox)

def on_move(x_pos, y_pos):
    # 子线程只做一件事：把坐标丢进队列，绝不碰Matplotlib的API
    coord_queue.put((x_pos, y_pos))

# 启动鼠标监听器
mouse_listener = mouse.Listener(on_move=on_move)
mouse_listener.start()

# 主线程负责处理绘图，所有Matplotlib操作都在这里完成
try:
    # 运行10秒左右，每秒刷新10次
    for _ in range(100):
        if not coord_queue.empty():
            x, y = coord_queue.get()
            points.set_data(x, y)
            
            # 恢复背景、重绘点、更新画布，这些操作必须在主线程执行
            fig.canvas.restore_region(background)
            ax.draw_artist(points)
            fig.canvas.blit(ax.bbox)
            # 强制刷新事件循环，保证实时性
            fig.canvas.flush_events()
        
        sleep(0.1)
finally:
    # 确保监听器能正确停止
    mouse_listener.stop()

关键修改点说明： #

• 线程安全队列：用queue.Queue隔离子线程和主线程的操作，避免直接跨线程调用Matplotlib API
• 主线程绘图：所有和画布相关的操作（restore_region、draw_artist、blit）都移到主线程循环里，严格遵守Matplotlib的线程安全要求
• 强制刷新事件：添加fig.canvas.flush_events()确保Matplotlib的事件循环及时处理绘图请求，保证近实时的绘制效果
• 优雅停止：用try-finally块保证监听器在程序结束时能正确停止，避免资源泄漏

如果需要长时间运行，把主循环改成while mouse_listener.is_alive()就行，不用固定循环次数。

内容的提问来源于stack exchange，提问作者M.T