PowerShell脚本输出同时显示控制台并保存至文件的问题

使用PowerShell（pwsh）运行C++项目构建脚本tbuild2.ps1，需实现构建输出同时显示在控制台，且完整保存到文件，尝试多种方法均存在问题：

• 直接使用Tee-Object仅保存小部分输出：

  tbuild2.ps1 | Tee-Object -FilePath "E:\ToolsPath\Temp\testfile2.log"
  

• 重定向命令仅保存文件，无控制台输出：

  $(我的脚本内容) *>&1 > E:\ToolsPath\Temp\Console.log
  

• Start-Transcript无法保存全部输出，仅记录控制台可见内容：

  Start-Transcript -path E:\ToolsPath\Temp\ConsoleMe.log -append
  tbuild2.ps1
  Stop-Transcript
  

• mtee工具无法正常工作，推测仅适用于cmd环境。

更新：尝试以下命令后，虽实现同时输出，但控制台内容全部变为红色：

tbuild2.ps1 *>&1 | Tee-Object -FilePath "E:\ToolsPath\Temp\testfile2.log"

核心原因说明 #

1. 输出不全：默认Tee-Object仅捕获标准输出流（stdout），未捕获错误流（stderr），而C++构建工具（如MSBuild、CMake）常将警告、错误输出到stderr，因此需要用*>&1将所有流合并到标准输出流。
2. 控制台全红：合并流后，PowerShell会保留错误记录的类型标记，因此控制台会用错误颜色（红色）显示这些内容，这是构建工具本身的输出流选择问题，而非PowerShell的bug。

方案一：保留原始输出颜色，完整保存内容 #

此方案能捕获所有输出，同时保留控制台的原始颜色区分（标准输出白、错误/警告红）：

tbuild2.ps1 *>&1 | Tee-Object -FilePath "E:\ToolsPath\Temp\testfile2.log"

如果控制台全红是因为构建工具将所有输出写入了stderr，可通过转换为字符串消除颜色标记：

tbuild2.ps1 *>&1 | ForEach-Object { "$_" } | Tee-Object -FilePath "E:\ToolsPath\Temp\testfile2.log"

方案二：自定义控制台颜色与输出控制 #

若需精细控制不同类型输出的显示颜色，可使用以下脚本：

$logFile = "E:\ToolsPath\Temp\testfile2.log"
# 可选：清空现有日志
if (Test-Path $logFile) { Remove-Item $logFile }

tbuild2.ps1 *>&1 | ForEach-Object {
    # 追加内容到日志文件
    $_ | Out-File -FilePath $logFile -Append -Encoding UTF8
    # 根据输出类型设置控制台颜色
    switch ($_) {
        { $_ -is [Management.Automation.ErrorRecord] } {
            Write-Host $_ -ForegroundColor Red
        }
        { $_ -is [Management.Automation.WarningRecord] } {
            Write-Host $_ -ForegroundColor Yellow
        }
        default {
            Write-Host $_ -ForegroundColor Gray
        }
    }
}

方案三：修复Start-Transcript的输出捕获问题 #

若偏好使用Start-Transcript，可通过Out-Host确保外部程序的所有输出被正确记录：

Start-Transcript -path "E:\ToolsPath\Temp\ConsoleMe.log" -append -IncludeInvocationHeader $false
tbuild2.ps1 *>&1 | Out-Host
Stop-Transcript

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