Windows 11 PowerShell执行docker build时如何捕获输出到文件

Windows环境下Docker CLI启动时会主动校验stdout关联的句柄类型，当PowerShell执行管道传递、原生输出重定向操作时，传递给docker进程的是管道句柄而非原生控制台句柄，就会触发failed to get console mode for stdout: The handle is invalid.报错。即使添加--progress plain参数关闭交互式进度条，该校验逻辑依然会执行，导致输出无法被正常捕获，构建流程本身不会受影响可正常完成。

• 方案1：通过cmd嵌套调用绕开句柄校验（推荐，支持同时输出到控制台+写入日志）
  借助cmd进程承接docker的输出流，Docker可以正确识别cmd下的重定向逻辑，不会触发句柄校验，再将流转回PowerShell实现控制台显示+日志落盘：

  # 替换docker build后的参数为实际业务使用的参数即可
  cmd /c "docker build --progress plain -t your-image-name . 2>&1" | Tee-Object -FilePath ./docker-build.log
  

  说明：命令中2>&1的作用是将Docker默认输出到stderr流的构建进度、警告、报错信息合并到stdout流，避免日志内容缺失。

• 方案2：使用Start-Process独立捕获输出流
  通过PowerShell的Start-Process启动docker进程，独立重定向stdout和stderr流，完全避开PowerShell管道对句柄的修改：

  $buildArgs = @("build", "--progress", "plain", "-t", "your-image-name", ".")
  Start-Process -FilePath "docker" -ArgumentList $buildArgs -NoNewWindow -Wait `
    -RedirectStandardOutput "./build-stdout.log" `
    -RedirectStandardError "./build-stderr.log"
  # 合并两个流的内容为完整日志
  Get-Content ./build-stdout.log, ./build-stderr.log | Set-Content ./docker-build.log
  # 如需在控制台实时显示日志，追加执行以下命令
  Get-Content ./docker-build.log
  

• 方案3：仅需写入日志不需要实时控制台输出时，可直接使用全流重定向配合cmd调用

  cmd /c "docker build --progress plain -t your-image-name . 2>&1" > ./docker-build.log
  

• 必须保留--progress plain参数：Docker默认的交互式TTY进度条是动态刷新的，本身不支持重定向捕获，即使解决句柄校验问题也无法正常写入日志。
• Windows 11默认预装PowerShell 5.x版本，该版本的重定向、管道实现会修改子进程的标准输入输出句柄属性，是触发Docker报错的核心诱因；升级到PowerShell 7+版本可部分缓解该问题，但通过cmd嵌套调用的方案兼容性最好，适配所有PowerShell版本。

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