在Deno中以子进程运行Docker Build时如何实现stdout实时流式输出

原代码无法实现实时输出的根源：

• 调用的p.output()方法本身逻辑就是阻塞等待子进程完全退出，一次性把stdout管道里的所有缓冲内容全部读完再返回，根本没有边读边传的能力，所有输出自然会攒到子进程执行完才一次性打出来。
• 整体逻辑是“等全部读完→再一次性写出”，完全不是流式处理的思路。

根据是否需要加工输出内容，可选择以下三种适配方案：

方案1：零中转继承（纯透传首选） #

如果不需要对Docker Build的输出做任何拦截、加工，只是想原样把日志实时打出来，这是最省事、性能最好的方案：

• 直接把子进程的stdout、stderr配置成inherit，让子进程直接绑定父进程的标准输出、错误输出的句柄，内核层面没有中间缓冲区中转，输出一点就打一点，完全没有延迟。

示例代码：

const p = Deno.run({
  cmd: ['docker', 'build', '.'],
  stdout: 'inherit',
  stderr: 'inherit'
});

// 等待子进程执行完成，校验退出状态
const status = await p.status();
if (!status.success) {
  console.error(`Docker Build 执行失败，退出码：${status.code}`);
}

方案2：流管道直通（需要关联输出但不加工） #

如果需要拿到子进程的stdout流做额外操作（比如同步把日志写到本地文件），但不需要修改输出内容，可以用原生流管道做实时透传：

• 保持stdout为piped配置，拿到子进程的stdout可读流之后，直接对接父进程的可写stdout流，读到一块数据就立刻写一块，不会等全部读完。

示例代码：

const p = Deno.run({
  cmd: ['docker', 'build', '.'],
  stdout: 'piped',
  stderr: 'inherit'
});

// 管道实时透传stdout内容，无全量缓冲
await p.stdout!.pipeTo(Deno.stdout.writable);

const status = await p.status();
if (!status.success) {
  console.error(`Docker Build 执行失败，退出码：${status.code}`);
}

方案3：逐块自定义处理（需要加工输出内容） #

如果需要对每一段输出做个性化处理（比如给每一行加时间戳、过滤无关的构建日志），可以用异步迭代器逐块读流，每读到一块就处理完立刻写出。

示例代码：

const p = Deno.run({
  cmd: ['docker', 'build', '.'],
  stdout: 'piped'
});

// 逐块读取子进程stdout，无需等待全量返回
for await (const chunk of p.stdout!) {
  // 可在此处对chunk做自定义处理，比如拼接日志前缀
  await Deno.stdout.write(chunk);
}

const status = await p.status();
if (!status.success) {
  console.error(`Docker Build 执行失败，退出码：${status.code}`);
}

• 在piped模式下千万别混着用p.output()、p.stdout()这类会全量读流的方法，不然直接回到等进程结束才输出的老问题。
• 要捕获Docker Build的错误日志的话，可以把stderr也设成piped，用同样的流式方式对接Deno.stderr，别让错误日志堵在缓冲区里出不来。

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