Linux下Pynput捕获按键后终端异常及输入转换错误问题

核心问题：代码逻辑错误导致的异常 #

你的问题主要是代码本身的问题，而非单纯Pynput在Linux上的兼容性问题。以下是具体问题点和修复方案：

1. Lambda表达式的变量引用错误

在get_key方法中，你通过lambda传递listener参数时，listener变量尚未被定义（with Listener(...) as listener语句才会创建该变量），导致on_release方法中调用listener.stop()时引用的是无效对象，无法正确停止监听。这会让Pynput持续捕获键盘输入，干扰后续的input()调用，进而出现输入内容乱码（如'mqe0.1'）和终端无回显的问题。

2. 终端状态未正确恢复

Pynput在Linux上会修改终端的输入模式，若监听未正常停止，终端的回显功能可能无法自动恢复，导致程序退出后输入仍不可见。

修复后的完整代码 #

import sys
import termios
from queue import Queue
from pynput.keyboard import Listener, KeyType

class Key:
    def __init__(self) -> None:
        pass
    
    def on_press(self, key: KeyType) -> None:
        pass
    
    def on_release(self, key: KeyType, queue: Queue) -> None:
        try:
            queue.put(key.char)
        except AttributeError:
            queue.put(key.name)

    def get_key(self, prompt_string: str) -> str:
        '''
        Prompts the user for a key.
        
        Args:
            prompt_string (str): A string representing the prompt to display to the user
            
        Returns:
            key (str): A key which the user pressed

        Examples:
            To prompt the user for a key and print the key that was pressed, use:

            >>> key = Key().get_key("Press a key: ")
            >>> print("You pressed:", key)
        '''
        key_queue = Queue()
        
        # 保存终端原始设置
        fd = sys.stdin.fileno()
        original_settings = termios.tcgetattr(fd)
        
        try:
            with Listener(on_press=self.on_press, on_release=lambda key: self.on_release(key, queue=key_queue)) as listener:
                print(prompt_string, end='', flush=True)
                key = key_queue.get()
                # 明确停止监听
                listener.stop()
                return key
        finally:
            # 恢复终端设置，确保回显正常
            termios.tcsetattr(fd, termios.TCSADRAIN, original_settings)

修复说明 #

• 移除listener参数传递：不再在on_release中停止监听，而是在get_key中获取到按键后直接调用listener.stop()，避免lambda的变量引用问题。
• 终端设置备份与恢复：使用termios模块保存和恢复终端的原始设置，确保无论监听是否正常结束，终端的回显功能都能恢复。
• 修正示例代码：示例中创建Key实例再调用get_key，符合类的使用逻辑。

修复后，后续调用input()时输入内容会正常显示，终端也不会出现无回显的异常。

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