如何防止Python CLI动画运行时用户按键显示在屏幕上？

这个问题确实很常见——默认情况下终端会把用户的按键输入回显到屏幕上，直接打断我们的动画效果。核心思路就是暂时关闭终端的回显功能，动画结束后再恢复，这样按键操作就不会显示出来了。下面分平台给你具体的实现方案：

方法1：Unix/Linux/macOS 系统（用termios模块） #

Unix类系统可以借助标准库的termios模块控制终端属性，我们可以写一个上下文管理器，方便安全地开启/关闭回显（就算动画被中断，也能自动恢复终端设置）：

import time
import termios
import sys

class DisableEcho:
    def __enter__(self):
        # 保存当前终端的原始属性
        self.old_attr = termios.tcgetattr(sys.stdin)
        # 创建属性副本，关闭回显（ECHO）标志位
        new_attr = self.old_attr.copy()
        new_attr[3] &= ~termios.ECHO
        termios.tcsetattr(sys.stdin, termios.TCSANOW, new_attr)
        return self
    
    def __exit__(self, exc_type, exc_val, exc_tb):
        # 不管有没有异常，都恢复终端原始属性
        termios.tcsetattr(sys.stdin, termios.TCSANOW, self.old_attr)

def animatedSpinner():
    animation = ["|","/","-","\\"]
    a = 0
    try:
        while True:
            print(animation[a % len(animation)], end="\r")
            a += 1
            time.sleep(0.1)
    except KeyboardInterrupt:
        # 捕获Ctrl+C，清理输出避免混乱
        print("\n动画已停止")

# 用上下文管理器包裹动画运行逻辑
if __name__ == "__main__":
    with DisableEcho():
        animatedSpinner()

方法2：Windows系统（用ctypes调用系统API） #

Windows没有termios模块，我们可以用ctypes直接调用Windows控制台API来关闭回显：

import time
import ctypes
from ctypes import wintypes

class DisableEcho:
    def __enter__(self):
        self.kernel32 = ctypes.WinDLL('kernel32', use_last_error=True)
        self.handle = self.kernel32.GetStdHandle(-10)  # 获取标准输入句柄
        # 读取当前控制台模式
        self.old_mode = wintypes.DWORD()
        self.kernel32.GetConsoleMode(self.handle, ctypes.byref(self.old_mode))
        # 关闭回显输入的标志位（ENABLE_ECHO_INPUT对应0x0004）
        new_mode = self.old_mode.value & ~0x0004
        self.kernel32.SetConsoleMode(self.handle, new_mode)
        return self
    
    def __exit__(self, exc_type, exc_val, exc_tb):
        # 恢复原始控制台模式
        self.kernel32.SetConsoleMode(self.handle, self.old_mode.value)

def animatedSpinner():
    animation = ["|","/","-","\\"]
    a = 0
    try:
        while True:
            print(animation[a % len(animation)], end="\r")
            a += 1
            time.sleep(0.1)
    except KeyboardInterrupt:
        print("\n动画已停止")

if __name__ == "__main__":
    with DisableEcho():
        animatedSpinner()

跨平台通用方案（自动适配系统） #

如果需要脚本在不同平台都能正常运行，可以把两种方案整合，自动检测当前系统：

import time
import sys

class DisableEcho:
    def __enter__(self):
        if sys.platform.startswith('win'):
            self._setup_windows()
        else:
            self._setup_unix()
        return self
    
    def _setup_unix(self):
        import termios
        self.old_attr = termios.tcgetattr(sys.stdin)
        new_attr = self.old_attr.copy()
        new_attr[3] &= ~termios.ECHO
        termios.tcsetattr(sys.stdin, termios.TCSANOW, new_attr)
    
    def _setup_windows(self):
        import ctypes
        from ctypes import wintypes
        self.kernel32 = ctypes.WinDLL('kernel32', use_last_error=True)
        self.handle = self.kernel32.GetStdHandle(-10)
        self.old_mode = wintypes.DWORD()
        self.kernel32.GetConsoleMode(self.handle, ctypes.byref(self.old_mode))
        new_mode = self.old_mode.value & ~0x0004
        self.kernel32.SetConsoleMode(self.handle, new_mode)
    
    def __exit__(self, exc_type, exc_val, exc_tb):
        if sys.platform.startswith('win'):
            self.kernel32.SetConsoleMode(self.handle, self.old_mode.value)
        else:
            import termios
            termios.tcsetattr(sys.stdin, termios.TCSANOW, self.old_attr)

def animatedSpinner():
    animation = ["|","/","-","\\"]
    a = 0
    try:
        while True:
            print(animation[a % len(animation)], end="\r")
            a += 1
            time.sleep(0.1)
    except KeyboardInterrupt:
        print("\n动画已停止")

if __name__ == "__main__":
    with DisableEcho():
        animatedSpinner()

这样不管在哪个系统运行，动画期间的按键都不会显示在屏幕上，而且即使动画被Ctrl+C中断，终端的回显功能也会自动恢复，不会留下操作异常的后遗症。

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