Python PTY无法响应Ctrl-C等控制码的问题如何解决

你的代码存在两个核心逻辑遗漏，导致写入的\x03（Ctrl+C）仅触发了终端回显，没有触发内核向前台进程发送SIGINT信号的逻辑，和你观察到的输出完全对应：

• 启动子进程时未添加start_new_session=True参数，子进程不会创建独立会话，也不会将slave PTY绑定为自身的控制终端，sleep进程根本不属于这个PTY的前台进程组。内核从master端收到INTR控制字符（默认映射为\x03）后，找不到要发送SIGINT信号的目标进程组，只会把这个字符当作普通输入处理。
• 父进程创建完master/slave文件描述符对之后，没有关闭自身持有的slave端fd，fd泄漏会导致PTY的进程组绑定、IO事件通知逻辑异常。
  你看到的输出b'^C'是PTY默认开启的输入回显功能把\x03回显后的结果，之后proc.wait()会阻塞整整5秒直到sleep正常执行完毕退出，所以退出码为0，进程根本没有被信号打断。

只需要补全两个关键操作即可让Ctrl+C正常生效，修正后的最小可运行代码如下：

import pty
import subprocess
import os
import time

master, slave = pty.openpty()

proc = subprocess.Popen(
    ['sleep', '5'],
    stdin=slave,
    stdout=slave,
    stderr=slave,
    # 关键配置：子进程启动独立新会话，自动将打开的slave PTY设为会话控制终端，注册为PTY前台进程组
    start_new_session=True
)
# 关键操作：父进程关闭自身持有的slave端fd，避免fd泄漏干扰PTY信号触发逻辑
os.close(slave)

# 短暂等待子进程完成初始化、绑定前台进程组，避免控制字符写入过早不生效
time.sleep(0.1)

os.write(master, b'\x03')  # 写入Ctrl+C控制码
print(os.read(master, 1024))
exit_code = proc.wait()
print(f"子进程退出码: {exit_code}")

运行上述代码后，进程不会等满5秒，会立刻被SIGINT信号打断退出，Linux环境下退出码为-2（对应信号编号2，即SIGINT），符合预期。
默认PTY的termios配置已经开启了ISIG（允许控制字符触发信号）、ECHO（输入回显）标志位，不需要额外修改termios即可支持Ctrl+C生效，如果需要自定义控制字符、关闭回显、调整终端模式，可通过termios库修改对应配置后写回PTY。

• xterm.js前端默认发送的控制字符序列和标准物理终端完全一致，WebSocket收到前端传来的内容后，无论是字符串还是二进制格式，直接原样写入PTY master端即可，不要做额外的转义、过滤、编码转换，否则会导致控制字符失效。
• PTY master端的读写建议用非阻塞IO配合IO多路复用（比如selectors、asyncio）实现，不要用阻塞式的read/write跑在主逻辑线程里，否则容易出现控制字符发送延迟、终端输出卡顿的问题。
• 除了Ctrl+C，Ctrl+D（EOF）、Ctrl+Z（SIGTSTP）等其他控制字符，只要没有手动修改termios关闭ISIG、ICANON等默认标志位，都可以直接生效，不需要额外编写逻辑处理。
• 如果需要适配终端窗口大小调整，要在前端监听resize事件拿到行列数后，调用fcntl.ioctl配合termios.TIOCSWINSZ把窗口大小参数写入PTY，否则会出现vim、htop等全屏类应用显示错乱的问题。

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