pynput 是 Windows/macOS/Linux 上最稳定跨平台的全局按键监听方案，通过原生 API 实现无焦点依赖监听，需注意 macOS 辅助功能授权、Linux Wayland 限制及组合键状态管理。
用 pynput 监听全局按键最直接可行
Windows/macOS/Linux 上真正能稳定捕获全局按键（包括焦点不在你的程序窗口时）的 Python 方案，pynput 是目前兼容性最好、文档最清晰的选择。它底层调用各平台原生 API（如 Windows 的 SetWindowsHookEx、macOS 的 Quartz、Linux 的 X11），不需要 root 或管理员权限（macOS 10.15+ 需手动授权辅助功能权限）。
安装只需：
pip install pynput
关键点：
-
Listener是核心类，必须用with语句或显式.start()/.stop()控制生命周期，否则线程可能残留 - 监听函数接收的是
Key（修饰键如Key.ctrl）或KeyCode（字母/数字键，如KeyCode.from_char('a')），不是字符串'a'，直接比对会失败 - 不要在回调里做耗时操作（如弹窗、网络请求），否则会卡住整个监听线程，导致按键丢失
如何正确识别组合快捷键（比如 Ctrl+Shift+X）
全局监听中，“按下顺序”和“是否同时按住”是判断组合键的关键。不能只靠 on_press 单次触发就判定——用户可能先按 Ctrl，再按 X，中间隔了半秒，这不该触发。
立即学习“Python免费学习笔记（深入）”；
推荐做法是维护一个按键状态集合：
- 在
on_press中把按键加入pressed_keys集合（注意：Key和KeyCode类型不同，需统一处理） - 在
on_release中移除对应按键 - 每次
on_press后检查当前集合是否包含目标组合，例如：{Key.ctrl_l, Key.shift, KeyCode.from_char('x')} - 避免用
in直接查event——event是单个按键对象，不是集合
macOS 上常见报错 quartz.CGEventCreateKeyboardEvent: Invalid argument
这个错误几乎只出现在 macOS 上，根本原因是系统阻止了未授权的辅助设备访问。即使代码没错，首次运行也会静默失败，监听完全不工作。
必须手动开启权限：
- 前往「系统设置 → 隐私与安全性 → 辅助功能」
- 点击左下角锁图标解锁，然后点击「+」号添加你的 Python 解释器（不是脚本！是
/usr/bin/python3、/opt/homebrew/bin/python3或venv/bin/python路径） - 重启监听程序，否则旧进程仍无权限
- 如果用 PyCharm 或 VS Code 运行，还要把 IDE 自身加进辅助功能列表（IDE 启动的 Python 子进程继承其权限）
监听到按键后触发自动化动作的注意事项
监听只是输入端，触发动作才是目的。但这里容易掉坑：
- 不要在监听回调里直接调用
subprocess.run(...)或os.system(...)执行 GUI 程序（如open -a Safari），macOS 下常因沙盒或会话上下文缺失而静默失败 - 跨平台启动应用建议用
webbrowser.open()（开网页）、subprocess.Popen(['open', '-a', 'App'])（macOS）、subprocess.Popen(['start', 'app.exe'])（Windows） - 如果要模拟按键（比如监听 Ctrl+T 后自动发 Ctrl+T 给浏览器），用
pynput.keyboard.Controller().press(...)，但注意：自己发的键也会被自己的监听器捕获，必须加防重入逻辑（比如设标志位或忽略来自本进程的事件） - Linux 下若用 Wayland，
pynput可能完全失效——这是协议限制，不是 bug，得换 X11 会话或用uinput（需 root）
全局键盘监听不是“注册个热键”那么简单，状态管理、平台差异、权限模型都得一个个对齐。最容易被忽略的是 macOS 权限授权后不重启进程，以及组合键判断时没清空旧状态导致误触发。
