Node.js如何执行shell命令并实时获取stdout输出流而无需等待命令执行完成

Node.js 完全支持该需求，你可以使用child_process模块提供的流式API实现实时获取shell进程的输出内容。

核心实现方案：使用spawn方法 #

spawn是child_process模块专门用于创建子进程的API，执行后会返回一个ChildProcess实例，实例上挂载了stdout、stderr两个可读流，监听流的data事件即可在输出内容生成时第一时间拿到数据，不需要等待进程执行完毕。

示例代码如下：

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

// 参数说明：
// 第一个参数：要执行的命令
// 第二个参数：命令的参数数组，无参数可传空数组
// 第三个参数：配置项，shell: true表示在shell环境中执行，和exec的默认行为一致
const longRunningProcess = spawn('/path/to/long-running-command', [], {
  shell: true
});

// 监听标准输出，实时打印内容
longRunningProcess.stdout.on('data', (chunk) => {
  // chunk默认是Buffer类型，调用toString()转成可读字符串
  console.log(chunk.toString());
});

// 监听标准错误输出，避免遗漏错误信息
longRunningProcess.stderr.on('data', (chunk) => {
  console.error('错误输出：', chunk.toString());
});

// 可选：监听进程退出事件
longRunningProcess.on('close', (exitCode) => {
  console.log(`命令执行完毕，退出码：${exitCode}`);
});

补充说明 #

• 如果你习惯了exec的回调写法也可以兼容实现：exec执行后同样会返回ChildProcess实例，直接监听其stdout的data事件即可同时保留原有的结束回调逻辑：

const { exec } = require("child_process")
const childProcess = exec('/path/to/long-running-commnd', function(err, stdout, stderr) {
  // 命令执行完成后的原有回调逻辑仍然生效
  console.log('全量输出：', stdout)
})
// 新增逻辑：实时获取输出
childProcess.stdout.on('data', chunk => console.log(chunk.toString()))

• 如果遇到输出仍然是批量返回的情况，通常是执行的命令本身在非TTY环境下开启了输出缓冲，可针对对应命令添加禁用缓冲的参数解决，比如运行Python脚本时添加-u参数。
• 不需要用到shell语法（比如管道、通配符）时，建议关闭shell: true配置，将命令和参数拆分传入spawn，安全性更高，比如执行ls -al可以写为spawn('ls', ['-al'])。

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