如何阻止pynput鼠标点击触发on_click函数两次

问题描述 #

我正在编写一个鼠标点击时自动截图的程序，基础功能正常，但发现pynput每次鼠标点击都会触发两次on_click函数，导致生成两张截图。我的目标是实现每次鼠标点击仅生成一张截图。

当前使用的代码如下：

import numpy as np
import cv2
import pyautogui
from pynput import mouse

COUNT = 0

def take_screenshot(x,y,button,pressed):
    COUNT+=1
    if button == mouse.Button.left:
        image = pyautogui.screenshot()
        image = cv2.cvtColor(np.array(image), cv2.COLOR_RGB2BGR)
        cv2.imwrite(f"image{COUNT}.png", image)

with mouse.Listener(on_click=take_screenshot) as listener:
    listener.join()

我尝试了几种方法，但要么导致鼠标反应异常，要么无法解决问题：

• 添加布尔值判断到if语句：

TAKEN = False
...
if button == mouse.Button.left and TAKEN == False:
    image = pyautogui.screenshot()
    image = cv2.cvtColor(np.array(image), cv2.COLOR_RGB2BGR)
    cv2.imwrite(f"image{COUNT}.png", image)
    TAKEN = True

• 用循环等方式包裹监听器
• 将监听器放入独立函数，但导致鼠标反应异常

参考相关问题后，我怀疑是鼠标按下和释放动作分别触发了事件，但查看pynput文档发现鼠标监听器没有类似键盘监听器的on_release参数。想请教：

1. 是否确实是该原因？若如此，有无未文档化的禁用选项？
2. 有没有其他工具可实现每次鼠标点击仅触发一次事件？

问题解答 #

1. 重复触发的原因及解决方法 #

确实是鼠标按下（pressed=True）和释放（pressed=False）两个动作分别触发了on_click回调，这是pynput鼠标监听器的默认行为——每次点击的按下和释放阶段都会调用一次回调函数，不存在未公开的禁用选项，但可以直接通过回调参数里的pressed值过滤事件。

你之前尝试的布尔值判断逻辑存在缺陷：只设置TAKEN=True却没有重置的时机，导致后续点击无法触发截图。正确的做法是仅在鼠标按下时执行截图逻辑，忽略释放事件。修改后的代码如下：

import numpy as np
import cv2
import pyautogui
from pynput import mouse

COUNT = 0

def take_screenshot(x, y, button, pressed):
    global COUNT
    # 仅响应左键按下事件
    if button == mouse.Button.left and pressed:
        COUNT += 1
        image = pyautogui.screenshot()
        image = cv2.cvtColor(np.array(image), cv2.COLOR_RGB2BGR)
        cv2.imwrite(f"image{COUNT}.png", image)

with mouse.Listener(on_click=take_screenshot) as listener:
    listener.join()

注意：必须给COUNT加上global声明，否则函数内无法修改全局变量的值。

2. 替代工具推荐 #

如果不想使用pynput，以下工具可以实现单次点击触发事件：

• pyautogui内置监听：pyautogui自带鼠标事件监听API，onMouseClick()默认在完整的点击动作（按下+释放完成）后触发一次回调：

import numpy as np
import cv2
import pyautogui

COUNT = 0

def take_screenshot(x, y, button, pressed):
    global COUNT
    if button == 'left':
        COUNT += 1
        image = pyautogui.screenshot()
        image = cv2.cvtColor(np.array(image), cv2.COLOR_RGB2BGR)
        cv2.imwrite(f"image{COUNT}.png", image)

# 绑定左键点击事件
pyautogui.onMouseClick(take_screenshot, button='left')
# 弹窗保持程序运行，关闭弹窗即停止监听
pyautogui.alert('点击确定后开始监听鼠标点击')

• mouse库：轻量级鼠标监听工具，API更简洁，on_click()默认每次左键点击只触发一次：

import numpy as np
import cv2
import pyautogui
import mouse

COUNT = 0

def take_screenshot():
    global COUNT
    COUNT += 1
    image = pyautogui.screenshot()
    image = cv2.cvtColor(np.array(image), cv2.COLOR_RGB2BGR)
    cv2.imwrite(f"image{COUNT}.png", image)

# 绑定左键点击事件
mouse.on_click(take_screenshot)
# 按回车键停止监听
input("按回车键退出监听...")

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