MacOS终端SWIG构建后光标无输出需reset恢复问题求助

问题描述 #

构建大型C转Python的SWIG目标后，MacOS Ventura 13.2.1终端出现异常：键盘输入无控制台显示、光标静止，但回车后命令可正常执行（例如输入ls看不到输入内容，回车却能正确列出目录）。执行reset命令可恢复控制台正常功能。

环境信息 #

• cmake 3.25.2
• swig 4.1.1
• Python 3.8.8
• Xcode 14.2

已尝试操作 #

• 执行reset命令恢复控制台输出
• 未找到相关在线讨论
• 未在SWIG文档中找到编译过程影响控制台输出的相关内容

期望效果 #

SWIG构建完成后，控制台可正常输入显示（例如输入123即时显示123）

2023年3月1日更新：终端属性对比 #

通过stty -a命令对比三种状态下的终端属性，发现关键差异：

默认状态下的stty -a输出 #

speed 9600 baud; 44 rows; 152 columns;
lflags: icanon isig iexten echo echoe -echok echoke -echonl echoctl
    -echoprt -altwerase -noflsh -tostop -flusho pendin -nokerninfo
    -extproc
iflags: -istrip icrnl -inlcr -igncr ixon -ixoff ixany imaxbel iutf8
    -ignbrk brkint -inpck -ignpar -parmrk
oflags: opost onlcr -oxtabs -onocr -onlret
cflags: cread cs8 -parenb -parodd hupcl -clocal -cstopb -crtscts -dsrflow
    -dtrflow -mdmbuf
cchars: discard = ^O; dsusp = ^Y; eof = ^D; eol = <undef>;
    eol2 = <undef>; erase = ^?; intr = ^C; kill = ^U; lnext = ^V;
    min = 1; quit = ^\; reprint = ^R; start = ^Q; status = ^T;
    stop = ^S; susp = ^Z; time = 0; werase = ^W;

SWIG运行后的stty -a输出 #

speed 9600 baud; 45 rows; 152 columns;
lflags: -icanon isig iexten -echo echoe -echok echoke -echonl echoctl
    -echoprt -altwerase -noflsh -tostop -flusho pendin -nokerninfo
    -extproc
iflags: -istrip icrnl -inlcr -igncr ixon -ixoff ixany imaxbel iutf8
    -ignbrk brkint -inpck -ignpar -parmrk
oflags: opost onlcr -oxtabs -onocr -onlret
cflags: cread cs8 -parenb -parodd hupcl -clocal -cstopb -crtscts -dsrflow
    -dtrflow -mdmbuf
cchars: discard = ^O; dsusp = ^Y; eof = ^D; eol = <undef>;
    eol2 = <undef>; erase = ^?; intr = ^C; kill = ^U; lnext = ^V;
    min = 1; quit = ^\; reprint = ^R; start = ^Q; status = ^T;
    stop = ^S; susp = ^Z; time = 0; werase = ^W;

执行reset后的stty -a输出 #

speed 9600 baud; 45 rows; 152 columns;
lflags: icanon isig iexten echo echoe echok echoke -echonl echoctl
        -echoprt -altwerase -noflsh -tostop -flusho pendin -nokerninfo
        -extproc
iflags: -istrip icrnl -inlcr -igncr ixon -ixoff -ixany imaxbel iutf8
        -ignbrk brkint -inpck ignpar -parmrk
oflags: opost onlcr oxtabs -onocr -onlret
cflags: cread cs8 -parenb -parodd hupcl -clocal -cstopb -crtscts -dsrflow
        -dtrflow -mdmbuf
cchars: discard = ^O; dsusp = ^Y; eof = ^D; eol = <undef>;
        eol2 = <undef>; erase = ^?; intr = ^C; kill = ^U; lnext = ^V;
        min = 1; quit = ^\; reprint = ^R; start = ^Q; status = ^T;
        stop = ^S; susp = ^Z; time = 0; werase = ^W;

原因分析 #

对比终端属性可知，SWIG构建过程修改了终端的两个关键lflags参数：

1. icanon被关闭：默认终端处于规范模式（icanon），会按行缓冲输入并处理编辑键；关闭后终端进入非规范模式，输入不会按行缓冲。
2. echo被关闭：默认终端会回显输入内容（echo）；关闭后输入的字符不会显示在控制台。

这两个参数的变化直接导致了输入无显示、光标静止的现象，而reset命令会将终端属性重置为默认值，因此能恢复正常。

该问题并非SWIG核心功能导致，大概率是构建流程中某个环节（如自动执行的测试脚本、生成的绑定代码中的终端控制逻辑）修改了终端属性后未正确恢复。

解决/规避方法 #

1. 手动快速恢复：构建完成后执行stty sane或stty icanon echo命令，比reset更轻量，可快速恢复终端输入回显和规范模式。
2. 自动恢复终端属性：修改CMake构建脚本，在SWIG目标构建完成后自动执行恢复命令。在CMakeLists.txt中添加：

   add_custom_command(TARGET your_swig_target POST_BUILD
       COMMAND stty sane
       COMMENT "Restoring terminal attributes after SWIG build"
   )
   

   替换your_swig_target为实际的SWIG目标名称。
3. 排查构建流程：检查SWIG生成的Python绑定代码、构建过程中的测试步骤，确认是否存在修改终端属性的代码，若有则添加对应的属性恢复逻辑。

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