Python中的pynput使用方法

更新時間：2026年02月12日 09:15:55 作者：方安樂

pynput是一個Python 庫,用于監(jiān)控和控制輸入設(shè)備,如鍵盤和鼠標,本文通過一個簡單的示例,展示如何使用pynput控制鼠標,本文結(jié)合實例代碼給大家介紹的非常詳細,感興趣的朋友一起看看吧

基本介紹

pynput 是一個 Python 庫，用于監(jiān)控和控制輸入設(shè)備，如鍵盤和鼠標。它允許你：

監(jiān)聽鼠標和鍵盤的事件（如移動、點擊、按鍵等）
控制鼠標和鍵盤（如模擬點擊、移動鼠標、按下按鍵等）

安裝方法

要使用 pynput ，首先需要安裝它：

pip install pynput

核心功能

鼠標控制與監(jiān)聽

pynput.mouse 模塊提供了以下功能：

鼠標監(jiān)聽：通過 mouse.Listener 類監(jiān)聽鼠標事件
鼠標控制：通過 mouse.Controller 類控制鼠標

from pynput import mouse
self.mouse_listener = mouse.Listener(
    on_move=self.on_mouse_move,
    on_click=self.on_mouse_click,
    on_scroll=self.on_mouse_scroll
)
self.mouse_listener.start()

其中：

on_move ：監(jiān)聽鼠標移動事件
on_click ：監(jiān)聽鼠標點擊事件
on_scroll ：監(jiān)聽鼠標滾輪事件

實現(xiàn)事件處理函數(shù) ：
- on_mouse_move ：處理鼠標移動事件，記錄鼠標位置
- on_mouse_click ：處理鼠標點擊事件，記錄點擊位置和狀態(tài)
- on_mouse_scroll ：處理鼠標滾輪事件，記錄滾動方向

停止監(jiān)聽器：

if self.mouse_listener:
    self.mouse_listener.stop()

鍵盤控制與監(jiān)聽

鍵盤監(jiān)聽：通過 keyboard.Listener 類監(jiān)聽鍵盤事件
鍵盤控制：通過 keyboard.Controller 類控制鍵盤

工作原理

當你創(chuàng)建并啟動 mouse.Listener 時，它會在后臺運行一個線程，持續(xù)監(jiān)聽鼠標事件。當檢測到事件時，會調(diào)用你提供的相應(yīng)回調(diào)函數(shù)。
這種設(shè)計使得監(jiān)聽器不會阻塞主線程的執(zhí)行，同時能夠?qū)崟r響應(yīng)輸入設(shè)備的變化。

其他功能

除了上述功能外， pynput 還提供了：

高級鼠標控制：可以設(shè)置鼠標位置、模擬點擊、控制滾輪等
高級鍵盤控制：可以模擬按鍵按下和釋放、組合鍵等
跨平臺支持：在 Windows、macOS 和 Linux 上都能正常工作

示例：使用 pynput 控制鼠標

以下是一個簡單的示例，展示如何使用 pynput 控制鼠標：

from pynput.mouse import Controller
mouse = Controller()
# 設(shè)置鼠標位置
mouse.position = (100, 200)
# 模擬點擊
mouse.click(mouse.Button.left, 1)  # 左鍵點擊一次
# 模擬滾輪滾動
mouse.scroll(0, 1)  # 向上滾動

示例：使用 pynput 監(jiān)聽鍵盤

以下是一個簡單的示例，展示如何使用 pynput 監(jiān)聽鍵盤：

from pynput import keyboard
def on_press(key):
    try:
        print(f'按鍵按下: {key.char}')
    except AttributeError:
        print(f'特殊按鍵按下: {key}')
def on_release(key):
    print(f'按鍵釋放: {key}')
    if key == keyboard.Key.esc:
        # 停止監(jiān)聽
        return False
# 啟動監(jiān)聽器
with keyboard.Listener(
        on_press=on_press,
        on_release=on_release) as listener:
    listener.join()