Python命令行工具中Ctrl+C触发EOFError异常的问题排查与修复

我完全理解你遇到的这个诡异循环问题——在中断后台操作后，Ctrl+C和输入行为变得完全不可预测：一会儿触发EOFError，一会儿又乱触发KeyboardInterrupt。这个问题的根源其实是终端输入缓冲区和Python信号处理的交互冲突，咱们一步步拆解：

问题原因分析 #

当你在parse函数的sleep期间按下Ctrl+C时，内核会向Python进程发送SIGINT信号，Python会将其转换为KeyboardInterrupt异常并捕获。但此时，终端驱动程序在发送信号的同时，会将当前输入缓冲区的内容标记为“中断”状态；而当程序回到input()调用时，这个残留的中断状态会让input()误以为已经读到了输入流的末尾（EOF），从而抛出EOFError。

更糟的是，一旦触发过一次这种异常，终端的输入缓冲区状态就会陷入混乱：后续的input()调用可能会随机读取到残留的中断信号字符，导致KeyboardInterrupt被错误触发，形成你看到的循环异常。

修复方案 #

解决的核心是在每次捕获到中断或EOF异常后，重置终端的输入缓冲区，清除残留的异常状态。我们可以借助Python的termios模块（Unix-like系统默认支持）来实现这个重置操作。

修改后的代码如下：

import time
import sys
import termios

def parse(inp):
    time.sleep(1)
    print(inp)
    if inp == 'e':
        return 'exit'

def reset_terminal_input():
    """重置终端输入缓冲区，清除残留的中断状态"""
    try:
        # TCIFLUSH 清除所有未读取的输入字符
        termios.tcflush(sys.stdin, termios.TCIFLUSH)
    except termios.error:
        # 非Unix系统（比如Windows）可能不支持termios，忽略即可
        pass

while True:
    try:
        user_in = input("> ").strip()
    except KeyboardInterrupt:
        print("\nKeyboardInterrupt")
        reset_terminal_input()
        continue
    except EOFError:
        print("\nEOFError")
        reset_terminal_input()
        continue
    except Exception as e:
        print(f"\n{e.__class__.__name__}")
        reset_terminal_input()
        continue
    
    if not user_in:
        continue
    
    try:
        if parse(user_in) == 'exit':
            break
    except KeyboardInterrupt:
        print("\nCancelled")
        reset_terminal_input()

关键改动说明： #

1. 新增reset_terminal_input函数：使用termios.tcflush清除终端输入缓冲区中所有未被读取的字符，彻底重置输入状态。
2. 异常处理后调用重置函数：无论是在input()阶段捕获到KeyboardInterrupt/EOFError，还是在parse阶段捕获到KeyboardInterrupt，都立即调用重置函数，确保下一次input()调用时终端处于正常状态。
3. 优化打印格式：在异常提示前添加换行符，避免和之前的输入提示符混淆，提升可读性。

测试验证 #

现在运行修改后的代码：

• 在parse执行期间按Ctrl+C，会打印Cancelled，然后终端输入状态被重置，下一次input()会正常等待输入。
• 按Ctrl+Z发送EOF，会打印EOFError，之后输入状态也会被重置，不会出现异常循环。
• 空输入、正常命令输入都能按预期工作。

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