macOS下Python无回显检测按键失效及%符号异常问题

问题原因分析 #

1. 按键仍回显：原代码每次调用is_key_pressed()时，仅短暂修改终端设置后立刻恢复，按键输入时终端已回到默认回显模式，导致字符被输出。
2. 结束后出现%符号：按下的按键字符未被程序读取，留在输入缓冲区中，程序退出后shell读取到残留内容，zsh会显示%作为提示符补充。

修改后的代码 #

import select
import sys
import termios
from time import sleep

def main():
    fd = sys.stdin.fileno()
    old_settings = termios.tcgetattr(fd)
    
    try:
        # 设置终端为非规范模式并关闭回显
        new_settings = termios.tcgetattr(fd)
        # 关闭ECHO（回显）和ICANON（规范模式，需回车才提交输入）
        new_settings[3] = new_settings[3] & ~(termios.ECHO | termios.ICANON)
        # 等所有输出传输完成后应用设置
        termios.tcsetattr(fd, termios.TCSADRAIN, new_settings)
        
        print("Testing select:")
        sleep_time = 1 / 60
        
        while True:
            sleep(sleep_time)
            # 检测是否有输入
            ready, _, _ = select.select([sys.stdin], [], [], 0)
            if ready:
                # 读取输入字符，清空缓冲区
                sys.stdin.read(1)
                break
    finally:
        # 恢复终端原始设置，确保退出后终端正常工作
        termios.tcsetattr(fd, termios.TCSAFLUSH, old_settings)

if __name__ == "__main__":
    main()

关键改动说明 #

• 终端设置全局化：将终端模式的修改和恢复移到main()函数首尾，确保整个检测过程中终端始终处于无回显、非规范模式，避免频繁切换导致的回显问题。
• 读取输入字符：检测到按键后调用sys.stdin.read(1)读取字符，清空输入缓冲区，防止残留内容被shell读取后产生多余的%符号。
• 简化逻辑：移除单独的is_key_pressed()函数，减少终端设置的反复切换，提升稳定性。

测试运行后，按下任意键程序会退出，既不会显示按键字符，也不会出现%符号。

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