为何PowerShell脚本与控制台运行时输出顺序不同？

问题原因 #

核心在于**Write-Host与对象管道输出的处理机制不同**，以及PowerShell在交互式和脚本模式下的输出行为差异：

• Write-Host的特性：它直接将内容写入控制台（宿主程序），绕过PowerShell的管道系统，内容会立即显示，不会被缓存。
• 对象输出的处理：直接输出$Items这类对象数组时，PowerShell会将其送入管道。在脚本模式下，PowerShell会先缓存整个脚本执行过程中产生的所有管道输出，直到脚本执行完毕后才统一交给格式化系统处理显示；而交互式控制台会在每段代码执行后立即处理管道输出，所以$Items的表格会在后续Write-Host内容前显示。
• $Items.Name的特殊情况：输出$Items.Name得到的是字符串数组，PowerShell对字符串、数字这类简单类型的管道输出会直接逐行显示，不需要额外格式化步骤，因此不会被缓存，能按代码顺序输出。

解决方法 #

要让对象按预期顺序输出，需强制PowerShell立即处理对象的管道输出，避免缓存，以下几种方法均可行：

方法1：用Out-Host强制立即显示 #

将$Items的输出修改为：

$Items | Out-Host

Out-Host会直接将对象输出到控制台，绕过后续管道缓存，确保内容立即显示。

方法2：用Write-Output配合Out-Host #

显式输出对象并强制送至控制台：

Write-Output $Items | Out-Host

效果与方法1一致，适合需要明确控制输出流程的场景。

方法3：预先格式化对象输出 #

使用Format-Table、Format-List等命令先格式化对象，格式化后的结果会立即输出：

$Items | Format-Table

该方法直接生成格式化文本，不会被管道缓存，能保证输出顺序符合预期。

验证示例 #

修改后的脚本代码：

$Items = @()
1..5 | % {
    $Item = [PsCustomObject]@{ Name = "Item$_" }
    $Items += $Item
    Write-Host "Item$_ has been added"
}

$Items | Out-Host

ForEach ($Item in $Items) {
    Write-Host "Displaying $($Item.Name)"
}

运行后输出顺序与交互式模式一致：

Item1 has been added
Item2 has been added
Item3 has been added
Item4 has been added
Item5 has been added

Name
----
Item1
Item2
Item3
Item4
Item5

Displaying Item1
Displaying Item2
Displaying Item3
Displaying Item4
Displaying Item5

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