1228 字

6 分钟

pynput第三方库

2025-10-02

Python

pynput第三方库#

此库允许您控制和监视输入设备。 ──官方文档 pynput pypi下载页 read the docs官方文档

WARNING
这篇博客最早写于23年，最近找回来清库存，有些内容可能已经过时

~~话说为什么python包都喜欢用Read The Docs做文档~~

想要使用python控制/监听键盘/鼠标行为，可以尝试pynput

以下我来介绍pynput中常用的键盘类，即pynput.keyboard。

或者尝试pyautogui，除了对于键鼠的控制，它提供了更多包括消息窗口、截图等功能。

Controller 模拟键盘按键#

导入#

使用前，导入Controller，并且实例化，同时，导入按键映射表Key

1
from pynput.keyboard import Key, Controller
2

3
keyboard = Controller()

模拟按键#

单个按键#

使用keyboard.press来模拟按下按键，然后通过keyboard.release模拟松开，两个函数都接受传入字符串，所以可以直接打出大写字母。

1
keyboard.press(Key.space) keyboard.release(Key.space)
2

3
keyboard.press('a')
4
keyboard.release('a')
5

6
keyboard.press('A')
7
keyboard.release('A')

或者使用按下Shift键来打出大写字母。

1
# 直接按下shift不放
2
keyboard.press(Key.shift)
3
keyboard.press('a')
4
keyboard.release('a')
5
keyboard.release(Key.shift)
6

7
# 或者使用上下文管理语句with，更推荐
8
with keyboard.pressed(Key.shift):
9
    keyboard.press('a')
10
    keyboard.release('a')

一串字符#

使用type()方法来方便地打印一串字符，其内部实现其实也是通过press()和release()来遍历这个字符串。

1
# 快速输入一段文本
2
keyboard.type('Hello, World!')
3

4
# 输入包含特殊字符的文本
5
keyboard.type('Special chars: !@#$%^&*()')

markdown

title: pynput第三方库 published: 2025-10-02 image: ” tags: [‘Python’] category: ‘Python’ draft: false#

pynput第三方库#

此库允许您控制和监视输入设备。 ──官方文档 pynput pypi下载页 read the docs官方文档

~~话说为什么python包都喜欢用Read The Docs做文档~~

想要使用python控制/监听键盘/鼠标行为，可以尝试pynput。这是一个功能强大且易于使用的库，能够帮助你实现各种输入设备的控制和监听功能。

以下我来介绍pynput中常用的键盘类，即pynput.keyboard。

或者尝试pyautogui，除了对于键鼠的控制，它提供了更多包括消息窗口、截图等功能。

Controller 模拟键盘按键#

导入#

使用前，导入Controller，并且实例化，同时，导入按键映射表Key

1
from pynput.keyboard import Key, Controller
2

3
keyboard = Controller()

模拟按键#

单个按键#

使用keyboard.press来模拟按下按键，然后通过keyboard.release模拟松开，两个函数都接受传入字符串，所以可以直接打出大写字母。

1
# 模拟空格键
2
keyboard.press(Key.space)
3
keyboard.release(Key.space)
4

5
# 模拟普通字母
6
keyboard.press('a')
7
keyboard.release('a')
8

9
# 模拟大写字母
10
keyboard.press('A')
11
keyboard.release('A')

或者使用按下Shift键来打出大写字母。

1
# 直接按下shift不放
2
keyboard.press(Key.shift)
3
keyboard.press('a')
4
keyboard.release('a')
5
keyboard.release(Key.shift)
6

7
# 或者使用上下文管理语句with，更推荐
8
with keyboard.pressed(Key.shift):
9
    keyboard.press('a')
10
    keyboard.release('a')

一串字符#

使用type()方法来方便地打印一串字符，其内部实现其实也是通过press()和release()来遍历这个字符串。

1
# 快速输入一段文本
2
keyboard.type('Hello, World!')
3

4
# 输入包含特殊字符的文本
5
keyboard.type('Special chars: !@#$%^&*()')

组合键#

使用pressed()方法可以方便地实现组合键的操作：

1
# Ctrl+C 复制
2
with keyboard.pressed(Key.ctrl):
3
    keyboard.press('c')
4
    keyboard.release('c')
5

6
# Alt+Tab 切换窗口
7
with keyboard.pressed(Key.alt):
8
    keyboard.press(Key.tab)
9
    keyboard.release(Key.tab)
10

11
# Ctrl+Alt+Delete 任务管理器
12
with keyboard.pressed(Key.ctrl):
13
    with keyboard.pressed(Key.alt):
14
        keyboard.press(Key.delete)
15
        keyboard.release(Key.delete)

Listener 监听键盘事件#

基本使用#

pynput不仅可以模拟按键，还可以监听键盘事件。使用Listener类可以实现对键盘输入的监听。

1
from pynput.keyboard import Listener
2

3
def on_press(key):
4
    print(f'按键 {key} 被按下')
5

6
def on_release(key):
7
    print(f'按键 {key} 被释放')
8
    if key == Key.esc:
9
        # 停止监听
10
        return False
11

12
# 创建监听器
13
with Listener(
14
        on_press=on_press,
15
        on_release=on_release) as listener:
16
    listener.join()

高级用法#

特殊按键处理#

1
from pynput.keyboard import Key, Listener
2

3
def on_press(key):
4
    try:
5
        print(f'字母键 {key.char} 被按下')
6
    except AttributeError:
7
        print(f'特殊键 {key} 被按下')
8

9
def on_release(key):
10
    if key == Key.esc:
11
        return False
12

13
with Listener(
14
        on_press=on_press,
15
        on_release=on_release) as listener:
16
    listener.join()

热键注册#

1
from pynput.keyboard import Key, Listener, HotKey
2

3
# 定义热键功能
4
def on_activate():
5
    print('热键被触发！')
6

7
# 创建热键
8
hotkey = HotKey(
9
    Key.f1,  # 触发键
10
    on_activate  # 触发函数
11
)
12

13
def for_canonical(f):
14
    return lambda k: f(hotkey.canonical(k))
15

16
# 监听键盘
17
with Listener(
18
        on_press=for_canonical(hotkey.press),
19
        on_release=for_canonical(hotkey.release)) as listener:
20
    listener.join()

实际应用示例#

1. 自动化文本输入器#

1
from pynput.keyboard import Controller, Key
2
import time
3

4
keyboard = Controller()
5

6
# 等待5秒，以便切换到目标窗口
7
time.sleep(5)
8

9
text = """
10
这是一个自动输入的示例。
11
可以用来快速输入重复性文本。
12
"""
13

14
keyboard.type(text)

2. 简单的按键记录器#

1
from pynput.keyboard import Listener
2
import logging
3

4
logging.basicConfig(
5
    filename='key_log.txt',
6
    level=logging.DEBUG,
7
    format='%(asctime)s: %(message)s'
8
)
9

10
def on_press(key):
11
    logging.info(str(key))
12

13
with Listener(on_press=on_press) as listener:
14
    listener.join()

3. 游戏辅助工具（示例：自动连发）#

1
from pynput.keyboard import Controller, Key, Listener
2
import threading
3
import time
4

5
keyboard = Controller()
6
auto_fire = False
7

8
def auto_fire_thread():
9
    while True:
10
        if auto_fire:
11
            keyboard.press('z')
12
            time.sleep(0.1)
13
            keyboard.release('z')
14
            time.sleep(0.1)
15

16
def on_press(key):
17
    global auto_fire
18
    if key == Key.f1:
19
        auto_fire = not auto_fire
20
        print(f'自动连发: {"开启" if auto_fire else "关闭"}')
21

22
# 启动自动连发线程
23
threading.Thread(target=auto_fire_thread, daemon=True).start()
24

25
# 监听键盘
26
with Listener(on_press=on_press) as listener:
27
    listener.join()