Windows终端中Python检测鼠标事件的问题及实现方法咨询

为什么之前的方案无效？ #

你试过的Stack Overflow方案和微软文档的C代码，核心都是直接读取控制台输入缓冲区，但默认情况下Windows控制台不会主动把鼠标事件写入输入缓冲区——只有当控制台处于特定模式，或者程序明确开启鼠标事件捕获权限时，鼠标事件才会被纳入输入流。而你之前的代码没有配置对应的控制台模式，所以只能捕获键盘事件。

textual库能正常工作，是因为它内部已经完成了底层配置：修改控制台输入模式以启用鼠标事件捕获，同时切换终端到原始模式，避免系统拦截鼠标事件，让事件能传递给程序。

如何手动实现鼠标事件检测？ #

提供两种可行的Python实现方式：

方式一：用ctypes调用Windows API手动配置 #

直接通过Windows控制台API修改模式并读取鼠标事件，步骤如下：

1. 获取控制台输入句柄
2. 修改控制台输入模式，启用鼠标事件
3. 循环读取输入事件，判断是否为鼠标事件

import ctypes
from ctypes import wintypes

# 定义Windows API相关结构和函数
kernel32 = ctypes.WinDLL('kernel32', use_last_error=True)

class COORD(ctypes.Structure):
    _fields_ = [("X", wintypes.SHORT), ("Y", wintypes.SHORT)]

class MOUSE_EVENT_RECORD(ctypes.Structure):
    _fields_ = [
        ("dwMousePosition", COORD),
        ("dwButtonState", wintypes.DWORD),
        ("dwControlKeyState", wintypes.DWORD),
        ("dwEventFlags", wintypes.DWORD)
    ]

class INPUT_RECORD(ctypes.Structure):
    _fields_ = [
        ("EventType", wintypes.WORD),
        ("Event", ctypes.Union(
            _fields_ = [
                ("MouseEvent", MOUSE_EVENT_RECORD),
                ("KeyEvent", wintypes.DWORD * 16)
            ]
        ))
    ]

# 常量定义
STD_INPUT_HANDLE = -10
ENABLE_MOUSE_INPUT = 0x0010
MOUSE_EVENT = 0x0002

# 获取输入句柄
h_input = kernel32.GetStdHandle(STD_INPUT_HANDLE)
if h_input == wintypes.HANDLE(-1).value:
    raise ctypes.WinError(ctypes.get_last_error())

# 获取并修改控制台模式
mode = wintypes.DWORD()
if not kernel32.GetConsoleMode(h_input, ctypes.byref(mode)):
    raise ctypes.WinError(ctypes.get_last_error())

if not kernel32.SetConsoleMode(h_input, mode.value | ENABLE_MOUSE_INPUT):
    raise ctypes.WinError(ctypes.get_last_error())

try:
    print("移动或点击鼠标，按Ctrl+C退出...")
    while True:
        records_read = wintypes.DWORD()
        ir = INPUT_RECORD()
        if not kernel32.ReadConsoleInputW(h_input, ctypes.byref(ir), 1, ctypes.byref(records_read)):
            raise ctypes.WinError(ctypes.get_last_error())
        if ir.EventType == MOUSE_EVENT:
            mouse_event = ir.Event.MouseEvent
            pos = mouse_event.dwMousePosition
            button_state = mouse_event.dwButtonState
            event_flags = mouse_event.dwEventFlags
            
            # 解析事件类型
            if event_flags == 0:
                if button_state & 0x0001:
                    print(f"左键按下，位置: ({pos.X}, {pos.Y})")
                elif button_state & 0x0002:
                    print(f"右键按下，位置: ({pos.X}, {pos.Y})")
            elif event_flags == 0x0001:
                print(f"鼠标移动，位置: ({pos.X}, {pos.Y})")
finally:
    # 恢复原控制台模式
    kernel32.SetConsoleMode(h_input, mode.value)

方式二：使用第三方库pynput #

如果不想处理底层API，可使用pynput库，它封装了跨平台的输入监听：

1. 安装库：pip install pynput
2. 编写监听代码：

from pynput.mouse import Listener

def on_move(x, y):
    print(f"鼠标移动到: ({x}, {y})")

def on_click(x, y, button, pressed):
    action = "按下" if pressed else "释放"
    print(f"{button} {action}，位置: ({x}, {y})")
    # 右键释放后退出监听
    if not pressed and button == button.right:
        return False

def on_scroll(x, y, dx, dy):
    print(f"鼠标滚动，位置: ({x}, {y})，滚动量: ({dx}, {dy})")

# 启动监听
with Listener(on_move=on_move, on_click=on_click, on_scroll=on_scroll) as listener:
    listener.join()

注意：pynput的监听是全局的，若需仅监听终端窗口内的事件，需结合窗口句柄判断，建议使用第一种方式。

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