PowerShell函数返回异常数组：为何return关键字未按预期生效？

核心原因 #

PowerShell函数的返回逻辑和多数编程语言不同：它会收集函数执行过程中所有输出到管道的内容，而非仅返回return语句指定的值。你代码里的Write-Output $policyTxtBlock会把输入的文本块写入输出流，后续return的PolicyEntry对象或$null也会被加入这个流，最终函数返回的就是包含这两个元素的数组。

修复方法 #

根据你的需求，有几种常见处理方式：

• 如果只是想在控制台打印调试信息，改用Write-Host（仅输出到控制台，不会进入返回流）：

  # 替换原Write-Output行
  Write-Host $policyTxtBlock
  

• 如果不需要这个调试输出，直接删除Write-Output $policyTxtBlock这一行即可。
• 若必须用Write-Output但不想让它进入返回值，可将其输出重定向到null：

  Write-Output $policyTxtBlock | Out-Null
  

修改后的完整示例 #

class PolicyEntry {
    [string]   $Type
    [string]   $Path
    [string]   $Key
    [string]   $Value
}

Function Parse-PolicyEntry([string]$policyTxtBlock) {
    # 调试输出改用Write-Host，不影响返回值
    Write-Host $policyTxtBlock
    $lines = $policyTxtBlock.Split("\n")
    $policyEntry = [PolicyEntry]::new()
    $valid = $false

    #...some logic...

    if ($valid) {
        return $policyEntry
    } else {
        return $null
    }
}

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