PowerShell函数为何会返回标准输出？（原标题：PowerShell向数组的数组追加元素时为何会追加标准输出？）

问题根源 #

这其实是PowerShell的核心特性——函数的返回值是整个执行过程中所有输出到管道的内容的集合，而不是仅return语句指定的内容。

你用的Write-Output本质是向管道发送数据，这些数据会被PowerShell自动收集到函数的返回结果里。哪怕你写了return $Result，之前Write-Output输出的字符串也已经进入管道，会和$Result的内容一起被打包成函数的返回值。

甚至你最后那个没有return的极简函数，它的返回值就是循环里Write-Output输出的所有内容——因为PowerShell默认会把函数中所有未被捕获的管道输出当作返回值。

解决办法 #

根据你的需求，有几种常用的方案：

1. 用Write-Host直接输出到控制台（最常用的调试场景） #

Write-Host的输出是直接发送到终端窗口，不会进入管道流，所以完全不会影响函数的返回值：

function WTF {
    $Result = @()
    $A = 1,2
    $B = 11,22
    $A,$B | % {
        Write-Host "Appending..."
        $Result += , $_
    }
    return $Result
}

执行$Thing = WTF时，控制台会显示调试信息，但$Thing里只有你预期的两个数组。

2. 用Write-Debug/Write-Information做可控调试输出 #

这两个cmdlet的输出默认不会显示，也不会进入管道流，需要手动开启才能看到调试信息，适合需要开关调试模式的场景：

• Write-Debug：先设置$DebugPreference = 'Continue'开启调试模式，再调用函数：

  function WTF {
      $Result = @()
      $A = 1,2
      $B = 11,22
      $A,$B | % {
          Write-Debug "Appending..."
          $Result += , $_
      }
      return $Result
  }
  

• Write-Information：可以通过参数直接开启输出，不用全局设置：

  function WTF {
      $Result = @()
      $A = 1,2
      $B = 11,22
      $A,$B | % {
          Write-Information "Appending..." -InformationAction Continue
          $Result += , $_
      }
      return $Result
  }
  

3. 临时重定向输出到$null（快速屏蔽） #

如果只是临时不想让调试信息混入返回值，又不想改cmdlet，可以把Write-Output的输出重定向到空：

function WTF {
    $Result = @()
    $A = 1,2
    $B = 11,22
    $A,$B | % {
        Write-Output "Appending..." > $null
        $Result += , $_
    }
    return $Result
}

不过这种方式会完全丢失调试信息，适合临时测试用。

额外小提示 #

尽量不要用Write-Output输出非返回值的内容——它的设计目的就是向管道传递数据，必然会被当作返回值的一部分。如果要输出调试或日志信息，优先用专门的控制台输出cmdlet。

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