Node.js调用child_process spawn执行命令无法捕获进度条输出问题

• 绝大多数带动态进度条的CLI工具都会检测输出目标是否为交互终端（TTY），如果检测到输出到管道（即被Node.js spawn调用的场景），会默认关闭动态进度条输出，或启用全缓冲机制，仅在缓冲区满或进程退出时才输出内容。
• Minecraft Overviewer的动态进度条使用回车符\r实现单行刷新，而非换行符\n，如果输出处理逻辑未适配\r分隔的内容，也会出现无法识别进度条的问题。
• Python默认对管道输出启用缓冲机制，实时输出的进度内容会被暂存到缓冲区，不会实时写入管道被Node.js捕获。

方法一：添加参数禁用缓冲、强制输出进度（成本最低，优先尝试） #

修改你的spawn调用参数，做两处调整：

1. 给Python解释器添加-u参数，强制禁用输出缓冲，所有内容实时输出
2. 给Overviewer添加--progress=text参数，强制不管输出目标是否为TTY，都输出文本格式的进度条
   修改后的代码片段如下：

const child_process = require('child_process');
const command       = "python";
// 新增 -u 参数和 --progress=text 参数
const arguments     = ["-u", "./Minecraft-Overviewer/overviewer.py", "--config=./world.py", "--progress=text"]

var child = child_process.spawn(command, arguments, {
    shell: true
});

child.on('error', (error) => {
    message.channel.send('Error!\r\n' + error);
});

// 处理输出时适配\r分隔的内容
child.stdout.on('data', (data) => {
    const content = data.toString('utf8');
    // 按\r或\n拆分每一行进度，过滤空内容
    const lines = content.split(/[\r\n]+/).filter(line => line.trim());
    lines.forEach(line => {
        // 仅输出非空的进度内容，避免频繁发空消息
        if (line) {
            message.channel.send(`STDOUT: ${line}`);
        }
    });
});

// stderr同理做相同处理
child.stderr.on('data', (data) => {
    const content = data.toString('utf8');
    const lines = content.split(/[\r\n]+/).filter(line => line.trim());
    lines.forEach(line => {
        if (line) {
            message.channel.send(`DATA: ${line}`);
        }
    });
});

child.on('close', (code) => {
    switch (code) {
        case 0:
            message.channel.send('Process exited.');
            break;
    }
});

方法二：使用伪终端模拟交互环境（方法一无效时使用） #

如果方法一无法生效，说明Overviewer严格校验TTY环境，此时可以使用node-pty包代替原生child_process，模拟交互终端运行命令，即可正常捕获所有进度输出：

1. 先安装依赖：npm install node-pty
2. 替换原有spawn逻辑：

const pty = require('node-pty');
const command = "python";
const args = ["./Minecraft-Overviewer/overviewer.py", "--config=./world.py"];

const child = pty.spawn(command, args, {
  name: 'xterm-color',
  cols: 200,
  rows: 30,
  cwd: process.cwd(),
  env: process.env
});

child.on('error', (error) => {
    message.channel.send('Error!\r\n' + error);
});

child.on('data', (data) => {
  const content = data.toString();
  const lines = content.split(/[\r\n]+/).filter(line => line.trim());
  lines.forEach(line => {
    if (line) {
      message.channel.send(`OUTPUT: ${line}`);
    }
  });
});

child.on('exit', (code) => {
  if (code === 0) {
    message.channel.send('Process exited.');
  }
});

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