为何MacOS iTerm2（ZSH）无需手动重置echo终端标志？

问题描述 #

我正在学习终端标志以构建终端UI，因此跟随《Entering Raw Mode》指南使用Zig进行开发。我编写了如下代码关闭echo：

const std = @import("std");
const c = @cImport({
    @cInclude("termios.h");
    @cInclude("unistd.h");
    @cInclude("stdlib.h");
});

const os = std.os;

pub fn disableEcho() !void {
    var raw = try os.tcgetattr(c.STDIN_FILENO);
    raw.lflag &= ~(@as(u32,c.ECHO));
    try os.tcsetattr(c.STDIN_FILENO, .FLUSH, raw);
}

pub fn main() !void {

    try disableEcho();

    var char: u8 = undefined;

    const stdin = std.io.getStdIn().reader();

    while (true) {
        char = try stdin.readByte();
        if (char == 'q') break;
        std.debug.print("c = {}\n\r", .{char});
    }

    std.debug.print("\n", .{});
}

运行程序时我发现echo仅在程序执行期间关闭，程序退出后echo自动恢复。但指南中提到‘我们应当在程序退出时恢复用户终端的原始属性’，我对此感到疑惑：这是预期行为吗？不同终端在状态恢复上是否存在差异？

注：我使用的是MacOS系统的iTerm2终端，且采用ZSH。另外，我曾误关闭更多终端标志，但程序退出后终端仍恢复正常，我原本以为会损坏终端并需要重启。

解答 #

• 当前行为是预期的，但依赖终端/Shell特性
  你看到的自动恢复，是现代终端模拟器（如iTerm2）和Shell（如ZSH）的防护机制——它们会在子进程退出后自动恢复终端的termios属性，避免程序异常退出导致终端状态混乱，属于提升用户体验的额外特性，并非POSIX强制要求。

• 指南要求手动恢复的原因
  这种自动恢复不是标准行为，在部分环境中并不存在：比如早期物理终端、极简终端模拟器、嵌入式系统终端等，程序退出后终端状态不会自动还原。如果你的程序在这些环境运行，未手动恢复会导致终端异常（如无输入回显、无法使用Ctrl+C中断）。
  即使在支持自动恢复的环境中，手动恢复也更严谨：比如程序通过exec替换进程、遇到特殊异常退出场景时，自动恢复可能失效。

• 不同终端的状态恢复差异

  • 现代GUI终端模拟器（iTerm2、Terminal.app、GNOME Terminal等）：几乎都支持自动恢复终端状态。
  • 纯文本环境tty（如服务器本地终端）：部分无自动恢复机制，依赖程序自行处理。
  • 嵌入式系统终端：大概率无自动恢复，必须手动处理终端属性。

• 正确的手动恢复实现方式
  需先保存终端原始属性，再通过defer（处理正常退出）和信号处理（处理异常退出）确保终端状态被恢复，示例代码如下：

const std = @import("std");
const c = @cImport({
    @cInclude("termios.h");
    @cInclude("unistd.h");
    @cInclude("stdlib.h");
});

const os = std.os;

var original_termios: c.termios = undefined;

pub fn enableEcho() !void {
    try os.tcsetattr(c.STDIN_FILENO, .FLUSH, original_termios);
}

pub fn disableEcho() !void {
    original_termios = try os.tcgetattr(c.STDIN_FILENO);
    var raw = original_termios;
    raw.lflag &= ~(@as(u32,c.ECHO));
    try os.tcsetattr(c.STDIN_FILENO, .FLUSH, raw);
}

// 信号处理函数，确保异常退出时恢复终端
fn handleSignal(signal: c_int) callconv(.C) void {
    _ = os.tcsetattr(c.STDIN_FILENO, .FLUSH, original_termios);
    os.exit(1);
}

pub fn main() !void {
    // 注册SIGINT（Ctrl+C）和SIGTERM信号处理
    const sigaction = os.Sigaction{
        .handler = .{ .handler = handleSignal },
        .mask = os.empty_sigset,
        .flags = 0,
    };
    try os.sigaction(os.SIGINT, &sigaction, null);
    try os.sigaction(os.SIGTERM, &sigaction, null);

    try disableEcho();
    defer enableEcho() catch {}; // 正常退出时自动触发恢复

    var char: u8 = undefined;
    const stdin = std.io.getStdIn().reader();

    while (true) {
        char = try stdin.readByte();
        if (char == 'q') break;
        std.debug.print("c = {}\n\r", .{char});
    }

    std.debug.print("\n", .{});
}

这个实现中：

• defer语句保证程序正常退出时自动恢复终端属性
• 信号处理函数覆盖了Ctrl+C强制终止、进程被杀死等异常退出场景
• 提前保存原始termios属性，避免修改后的属性覆盖原始配置

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