Mac Ventura下Python3终端聚焦时无法捕获键盘输入问题

问题背景 #

要搭建Python程序实现终端输入字符时输出凯撒移位结果（输入'a'输出'n'，输入'b'输出'o'），选用keyboard库后出现异常：

• 终端聚焦时按'a'，仅显示输入的'a'，程序无响应
• 终端失焦时按'a'，程序正常输出捕获日志
  已给终端授予Accessibility权限并通过sudo运行程序。

问题原因 #

Mac终端在聚焦状态下会优先捕获按键事件用于自身的输入渲染，keyboard库的全局按键钩子优先级低于终端的输入处理逻辑，导致终端聚焦时钩子无法获取到按键事件；终端失焦时，按键事件不会被终端拦截，因此钩子能正常工作。

解决方案 #

针对终端内输入的场景，无需使用全局按键钩子，直接读取终端标准输入即可，这种方式更可靠且避免系统权限和事件拦截问题。

示例代码 #

import sys

def caesar_shift(char):
    # 实现凯撒移位（偏移量13）
    if char.islower():
        return chr((ord(char) - ord('a') + 13) % 26 + ord('a'))
    elif char.isupper():
        return chr((ord(char) - ord('A') + 13) % 26 + ord('A'))
    return char

print("输入字符，按Ctrl+C退出程序：")
while True:
    try:
        # 读取单个字符（无需回车触发）
        char = sys.stdin.read(1)
        if not char:
            break
        # 输出移位结果
        shifted_char = caesar_shift(char)
        print(f"输入: {char.strip()} → 移位结果: {shifted_char}", flush=True)
    except KeyboardInterrupt:
        print("\n程序已退出")
        break

代码说明 #

• 使用sys.stdin.read(1)实时读取终端输入的单个字符，无需用户按回车
• 实现凯撒移位逻辑，仅对大小写字母处理，其他字符直接返回
• 通过flush=True确保输出实时显示
• 支持按Ctrl+C正常退出程序

替代方案（若坚持使用keyboard库） #

如果必须使用keyboard库，可尝试以下操作，但可靠性低于标准输入方案：

• 运行程序时禁用终端的本地输入（可通过终端设置或第三方工具实现）
• 使用keyboard.hook()替代on_press_key()，并在回调中尝试阻止事件传递，但Mac系统可能限制该操作

内容的提问来源于stack exchange，提问作者Linen Soup