基于crossterm的Rust终端UI作为Node.js子进程启动时输入初始化失败

我用Crossterm开发了一个需要处理键盘输入的Rust终端UI，直接运行完全正常，但通过Node.js作为子进程启动时，会抛出运行时错误“Failed to initialize input reader”。

最小复现示例 #

index.js #

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

const runMinimalCrossterm = () => {
  const rustProcess = spawn('cargo', ['run', '--bin', 'poll'], {
    cwd: '/project/path',
    stdio: ['pipe', 'pipe', 'pipe'],
  });

  rustProcess.stdout.on('data', (data) => {
    console.log(`Rust says: ${data}`);
  });

  rustProcess.stderr.on('data', (data) => {
    console.error(`Rust error: ${data}`);
  });

  rustProcess.on('close', (code) => {
    console.log(`Rust process exited with code ${code}`);
  });

  if (rustProcess.stdin) {
    rustProcess.stdin.write('q\n');
    rustProcess.stdin.end();
  } else {
    console.error("Failed to initialize stdin for the Rust process");
  }
};

runMinimalCrossterm();

main.rs #

use crossterm::event::{self, Event, KeyCode};
use crossterm::terminal::{enable_raw_mode, disable_raw_mode};
use std::io::{self, Write};
use std::time::Duration;

fn main() -> io::Result<()> {
    enable_raw_mode().expect("Failed to enable raw mode");
    println!("Polling for events. Press 'q' to exit.");

    loop {
        match event::poll(Duration::from_secs(10)) {
            Ok(true) => {
                match event::read() {
                    Ok(Event::Key(key_event)) => {
                        println!("Event: {:?}", key_event);
                        if key_event.code == KeyCode::Char('q') {
                            println!("Exiting...");
                            break;
                        }
                    }
                    Ok(event) => {
                        println!("Event: {:?}", event);
                    }
                    Err(e) => {
                        eprintln!("Error reading event: {}", e);
                    }
                }
            }
            Ok(false) => {
                println!("No events polled within timeout.");
            }
            Err(e) => {
                eprintln!("Failed to poll event: {}", e);
                break;
            }
        }
    }

    disable_raw_mode().expect("Failed to disable raw mode");
    Ok(())
}

运行结果对比 #

Node.js启动子进程的输出 #

Rust error:      Running `target/debug/poll`

Rust says: Polling for events. Press 'q' to exit.

Rust error: Failed to poll event: Failed to initialize input reader

Rust process exited with code 0

直接运行Rust程序的输出 #

Polling for events. Press 'q' to exit.
q
Event: KeyEvent { code: Char('q'), modifiers: KeyModifiers(0x0), kind: Press, state: KeyEventState(0x0) }
Exiting...

解决方案 #

原因分析 #

Crossterm的event::poll和event::readAPI依赖**真实终端（TTY）**来捕获键盘事件。当Node.js用stdio: ['pipe', 'pipe', 'pipe']启动子进程时，子进程的标准输入/输出被替换为管道，而非真实终端，导致Crossterm无法初始化输入读取器。直接运行Rust程序时，stdin/stdout默认绑定到终端，因此可以正常工作。

方案1：让子进程继承父进程终端（支持用户直接交互） #

如果需要用户直接在终端操作Rust程序，将子进程的stdio设置为inherit，让它继承Node.js进程的终端：

const rustProcess = spawn('cargo', ['run', '--bin', 'poll'], {
  cwd: '/project/path',
  stdio: 'inherit', // 等价于 ['inherit', 'inherit', 'inherit']
});

此时Rust程序会直接使用终端接收用户输入，无需Node.js手动写入stdin。

方案2：修改Rust代码用管道读取输入（适合进程间通信） #

如果需要Node.js和Rust程序通过管道通信，而非用户直接交互，需要修改Rust代码，放弃Crossterm的终端事件API，直接从标准输入读取数据：

use std::io::{self, BufRead};

fn main() -> io::Result<()> {
    println!("Waiting for input. Enter 'q' to exit.");

    let stdin = io::stdin();
    for line in stdin.lock().lines() {
        let input = line?;
        println!("Received: {}", input);
        if input.trim() == "q" {
            println!("Exiting...");
            break;
        }
    }

    Ok(())
}

修改后Node.js可以通过rustProcess.stdin.write()给Rust程序发送数据，Rust能正常读取并处理。

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