进程从后台恢复后stdin.setRawMode(true)失效问题咨询

当你遇到进程前后台切换后setRawMode(true)失效的情况，别慌——这是终端（TTY）的保护机制在起作用，不是Node.js的bug。

为什么会出现这个问题？ #

当你用process.kill(process.pid, 'SIGSTOP')把进程转入后台，再用fg恢复时，终端内核会自动将TTY从原始模式（raw mode）切换回规范模式（canonical mode）。这个操作是终端层面的，和Node.js的用户空间设置无关：

• 原始模式下，终端会把每个按键直接发送给进程，不需要等待回车
• 规范模式下，终端会缓冲输入，直到你按下回车才把整行数据发送给进程

Node.js的process.stdin.setRawMode(true)只是在用户层面对stdin的行为做了配置，但终端内核的模式重置会覆盖这个设置。哪怕你之后再调用setRawMode(true)，如果不同步终端的实际状态，也不会生效。

怎么解决？ #

核心思路是：在进程被恢复到前台时（收到SIGCONT信号），重新初始化stdin的原始模式，并同步终端状态。

这里有两个可靠的实现方案：

方案1：通过Node.js内置API重置stdin状态

监听SIGCONT信号，在信号触发时先暂停stdin，重新设置原始模式，再恢复stdin，确保终端和Node.js的状态同步：

// 初始化原始模式
process.stdin.setRawMode(true);
process.stdin.resume();

// 监听进程恢复信号
process.on('SIGCONT', () => {
  // 先暂停再恢复，强制同步终端状态
  process.stdin.pause();
  process.stdin.setRawMode(true);
  process.stdin.resume();
  console.log('进程已恢复，重新开启原始输入模式');
});

// 处理按键输入
process.stdin.on('data', (data) => {
  const key = data.toString();
  console.log(`捕获按键: ${key}`);
  // 按q退出程序
  if (key === 'q') {
    process.exit(0);
  }
});

// 测试用：发送SIGUSR1信号触发后台切换
process.on('SIGUSR1', () => {
  console.log('将进程转入后台...');
  process.kill(process.pid, 'SIGSTOP');
});

方案2：结合系统命令强制设置终端模式（备选）

如果方案1偶尔失效，可以手动调用系统的stty命令强制将终端设为原始模式，再同步Node.js的设置：

const { execSync } = require('child_process');

process.stdin.setRawMode(true);
process.stdin.resume();

process.on('SIGCONT', () => {
  // 用stty命令强制设置终端为raw模式
  execSync('stty raw');
  process.stdin.setRawMode(true);
  process.stdin.resume();
  console.log('终端模式已重置，恢复原始输入');
});

// 输入处理逻辑同上...

额外注意事项 #

• 不要忽略process.stdin.resume()：如果stdin处于暂停状态，即使设置了原始模式也不会捕获输入
• 测试时可以用kill -USR1 <pid>触发后台切换，方便调试
• 不同终端（比如bash、zsh、tmux）的行为可能略有差异，但核心解决思路一致

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