Keyboard库不支持真正的全局快捷键，需用add_hotkey()配合常驻机制；is_pressed()因无防抖和轮询问题不可靠，应改用事件回调；跨平台需注意修饰键命名差异、权限及焦点限制。
Keyboard 库本身不支持全局快捷键注册（比如 Win+R 或 Ctrl+Alt+T 这类系统级热键），它只能监听按键按下/释放事件，且在 Windows/macOS/Linux 上行为差异大；真要实现“按下组合键就运行脚本”，得用 keyboard.add_hotkey() 配合后台常驻，但必须注意权限、焦点和跨平台兼容性问题。
为什么 keyboard.is_pressed() 在循环里不可靠
很多人写 while True: + if keyboard.is_pressed("ctrl+q"): 想做快捷键，结果要么触发多次，要么漏触发——因为 is_pressed() 是瞬时状态检测，没做防抖和事件去重，而且轮询间隔受 time.sleep() 影响，CPU 占用还高。
- 正确做法是用
keyboard.on_press_key()或keyboard.add_hotkey()基于事件回调 -
add_hotkey()内部已处理按键释放判定和重复抑制，适合快捷键场景 - 若需区分“长按”和“短按”，得自己记录时间戳，
is_pressed()无法单独支撑
keyboard.add_hotkey() 的参数陷阱
组合键写法看着简单，实际容易因顺序、大小写、修饰键名不一致而失效。例如 "ctrl+r" 在 macOS 上不会触发（应为 "cmd+r"），而 "Ctrl+R" 在 Windows 下可能失败（修饰键名必须小写）。
- 统一用小写字母：正确的写法是
"ctrl+r"、"shift+alt+q" - Mac 用户注意：
"cmd"替代"ctrl"，"option"替代"alt"；但keyboard对 macOS 的 cmd 键支持有限，部分版本需加suppress=True才能拦截 - 回调函数不能带参数，如需传参请用
lambda或functools.partial - 热键注册后，若脚本失去焦点（比如切到浏览器），Windows 默认仍可响应，macOS 则大概率失效——这不是 bug，是系统限制
如何让脚本常驻并安全退出
用 keyboard.add_hotkey() 注册后，主线程若直接结束，热键就失效。常见错误是没加阻塞逻辑，或者用 input() 导致无法响应快捷键（因为 input() 抢占了 stdin）。
立即学习“Python免费学习笔记（深入）”；
- 最简方式：调用
keyboard.wait()，它会阻塞并保持热键活跃，直到收到指定键（如keyboard.wait("esc")）或被信号中断 - 更可控的方式：启动一个后台线程监听热键，主线程用
threading.Event().wait()阻塞，退出时设 flag + 调用keyboard.unhook_all() - Windows 下建议以管理员权限运行，否则某些全局钩子（尤其涉及
Ctrl+Shift类组合）会被系统拒绝 - Linux 用户需确保有
uinput权限，否则keyboard初始化就会抛OSError: uinput not available
真正难的不是注册热键，而是处理不同系统的修饰键映射、权限获取、以及热键与目标应用的冲突（比如你设了 Ctrl+C，但当前焦点在终端里，就可能被截断或忽略）。别指望一次写完全平台通用——先跑通一个系统，再按需适配。
