Python keyboard 库：从安装到实战应用

场景三：自动化文本输入

需要自动填写表单或发送消息？write() 方法帮你搞定：

import keyboard
import time

# 等待 3 秒后开始输入
time.sleep(3)
keyboard.write('Hello, World! 这是一段自动输入的文字。')

场景四：按键状态检测

判断特定按键是否被按下：

import keyboard

while True:
    if keyboard.is_pressed('space'):
        print('空格键被按下了!')
        break

场景五：宏录制与回放

录制你的操作并重复执行：

import keyboard

print('开始录制...按 ESC 停止')
recorded = keyboard.record(until='esc')
print('录制完成！开始回放...')
keyboard.play(recorded, speed_factor=2) # 2 倍速回放

高级技巧：解决常见问题

问题 1：程序立即退出

❌ 错误做法：

keyboard.add_hotkey('space', lambda: print('按了空格!')) # 程序执行完毕，热键失效

✅ 正确做法：

keyboard.add_hotkey('space', lambda: print('按了空格!'))
keyboard.wait() # 永久阻塞

问题 2：CPU 占用率过高

❌ 错误做法：

while not keyboard.is_pressed('space'): continue
print('检测到空格!')

✅ 推荐做法：

keyboard.wait('space')
print('检测到空格!')

问题 3：回调函数执行时机

❌ 错误做法：

keyboard.add_hotkey('space', print('空格被按了'))

✅ 正确做法：

keyboard.add_hotkey('space', lambda: print('空格被按了'))

项目结构深度解析

了解项目结构有助于更好地使用这个库：

keyboard/
├── keyboard/ # 核心源码目录
│   ├── __init__.py # 主要 API 接口
│   ├── _keyboard_event.py # 事件处理
│   ├── _winkeyboard.py # Windows 实现
│   └── _nixkeyboard.py # Linux 实现
├── examples/ # 实用示例代码
│   ├── pressed_keys.py # 按键状态检测
│   ├── customizable_hotkey.py # 可配置热键
│   └── 10_second_macro.py # 宏录制示例
└── setup.py # 安装配置

平台适配指南

Windows 系统

• 无需特殊权限
• 支持按键抑制功能
• 完整的媒体键支持

Linux 系统

• 需要 root 权限
• 通过读取设备文件实现
• 部分媒体键可能无法识别

macOS 系统

• 实验性支持
• 功能可能受限

重要注意事项

1. 权限要求：Linux 系统下需要 sudo 权限才能正常工作
2. SSH 限制：通过 SSH 连接时无法捕获键盘事件
3. 游戏兼容：部分游戏可能拦截所有键盘事件
4. 使用规范：请勿用于恶意目的，如键盘记录器或不当用途

总结

Python keyboard 库为开发者提供了强大的键盘控制能力，从简单的按键监听到复杂的宏操作，都能轻松实现。通过本文的指南，相信你已经掌握了：

• 库的安装方法
• 基础功能使用
• 常见问题解决
• 高级应用技巧

现在就开始使用 keyboard 库，让你的 Python 程序拥有更强大的交互能力！

记住，强大的工具需要负责任的使用。