Windows下运行PyTermGUI报signal模块无SIGWINCH属性错误如何解决

算力阿峰

2026-10-2

关于`SIGWINCH`的作用

SIGWINCH是类Unix系统下的专用信号，全称是Window Change Signal，当终端窗口的尺寸发生变化时，系统会给当前运行的终端程序发送这个信号，TUI库一般会监听这个信号来触发界面重绘，适配新的窗口尺寸。Windows系统没有实现这个信号，所以会触发AttributeError。

无需修改PyTermGUI源码的解决方案

方案1：使用Windows Terminal替代原生cmd/PowerShell运行程序
高版本Windows Terminal已经对部分Unix信号做了兼容模拟，多数情况下可以直接规避这个报错，不需要修改任何代码。
方案2：在程序入口处提前注入模拟的SIGWINCH属性
在你自己的代码最开头、导入PyTermGUI之前，手动给signal模块补一个不存在的SIGWINCH属性，示例代码如下：
```
import sys
import signal

if sys.platform == "win32":
    # 给Windows系统补一个不存在的SIGWINCH，值随便填一个不冲突的整数即可
    signal.SIGWINCH = 10
```
这行代码会骗过PyTermGUI的信号监听逻辑，不会再抛出属性不存在的报错。如果需要窗口resize功能，你可以额外加一个定时轮询窗口尺寸的逻辑来替代信号监听，不需要改动PyTermGUI的源码。
方案3：运行程序前设置环境变量禁用PyTermGUI的resize监听
部分版本的PyTermGUI支持通过环境变量关闭窗口尺寸变化监听功能，在运行程序前执行对应命令即可：
```
# cmd下执行
set PTG_NO_WINCH=1
python your_script.py
```
```
# PowerShell下执行
$env:PTG_NO_WINCH=1
python your_script.py
```