WSL2 Ubuntu中禁用终端echo功能失效问题排查

问题背景 #

在WSL2 Ubuntu环境下编译运行以下C程序，预期关闭标准输入的echo功能，让用户输入一行文本后显示输入内容，最后恢复echo功能，但终端仍会回显输入内容，请问问题出在哪里？

原程序代码 #

#include <stdio.h>
#include <unistd.h>
#include <termios.h>

int main(int argc, void **argv) {
  struct termios term;
  char input[256];

  if(tcgetattr(STDIN_FILENO, &term) < 0) {
    perror("tcgetattr");
    return 1;
  }

  printf("term.c_iflag: %x\n", term.c_iflag);
  term.c_iflag &= ~ECHO;

  if(tcsetattr(STDIN_FILENO, TCSANOW, &term) < 0) {
    perror("tcsetattr");
    return 1;
  }

  printf("Echo mode disabled.\n");
  printf("term.c_iflag: %x\n", term.c_iflag);

  fgets(input, sizeof(input), stdin);
  printf("Entered: %s\n", input);

  term.c_iflag |= ECHO;
  if(tcsetattr(STDIN_FILENO, TCSANOW, &term) < 0) {
    perror("tcsetattr");
    return 1;
  }

  printf("term.c_iflag: %x\n", term.c_iflag);
  return 0;
}

程序运行输出 #

term.c_iflag: 50a
Echo mode disabled.
term.c_iflag: 502
this should not be visible
Entered: this should not be visible

term.c_iflag: 50a

问题原因 #

核心错误是ECHO标志位不属于c_iflag（输入模式标志），而是属于c_lflag（本地模式标志）。你代码里一直在修改c_iflag，根本没碰控制终端回显的正确字段，所以回显功能自然不会被关闭。

修正后的代码 #

#include <stdio.h>
#include <unistd.h>
#include <termios.h>
#include <signal.h>

struct termios original_term;

// 捕获异常信号，确保退出时恢复终端设置
void restore_term(int sig) {
    tcsetattr(STDIN_FILENO, TCSANOW, &original_term);
    _exit(0);
}

int main(int argc, char **argv) {
    struct termios term;
    char input[256];

    if(tcgetattr(STDIN_FILENO, &term) < 0) {
        perror("tcgetattr");
        return 1;
    }
    original_term = term; // 保存原始终端属性

    // 注册信号处理，避免程序异常退出导致终端状态异常
    signal(SIGINT, restore_term);
    signal(SIGTERM, restore_term);

    printf("term.c_lflag (original): %x\n", term.c_lflag);
    term.c_lflag &= ~ECHO; // 修改正确的字段

    if(tcsetattr(STDIN_FILENO, TCSANOW, &term) < 0) {
        perror("tcsetattr");
        restore_term(0);
        return 1;
    }

    printf("Echo mode disabled.\n");
    printf("term.c_lflag (modified): %x\n", term.c_lflag);

    fgets(input, sizeof(input), stdin);
    printf("Entered: %s\n", input);

    // 恢复原始终端属性
    if(tcsetattr(STDIN_FILENO, TCSANOW, &original_term) < 0) {
        perror("tcsetattr");
        return 1;
    }

    printf("term.c_lflag (restored): %x\n", original_term.c_lflag);
    return 0;
}

额外说明 #

1. 除了修正ECHO的归属字段，还建议保存原始终端属性，并注册信号处理函数。如果程序因Ctrl+C等异常信号退出，终端不会一直处于无回显的异常状态。
2. TCSANOW参数表示立即应用终端属性修改，无需等待输入输出队列清空。

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