PowerShell函数如何同时输出到控制台并返回值，避免重复输出？

你的核心问题是：直接调用函数时，Write-Host的输出和函数返回值的默认控制台输出重复了。要实现任何场景下控制台都显示输入信息+结果，同时返回值可被捕获的需求，我们可以通过判断函数输出是否被捕获（赋值/管道）来控制控制台输出逻辑，避免重复。

改进后的函数实现 #

function Write-OutAndReturn {
    [CmdletBinding()]
    param(
        [Parameter(Mandatory)]
        [ScriptBlock]$ScriptBlock
    )

    # 执行脚本块计算结果
    $result = & $ScriptBlock

    # 固定显示输入信息（任何场景都输出）
    Write-Host "=== 输入信息 ==="
    Write-Host "执行的脚本块: $($ScriptBlock.ToString().Trim())"

    # 判断结果是否被捕获（赋值/管道到其他命令）
    $isResultCaptured = $false
    # 检查调用行是否包含赋值操作
    $invocationLine = $MyInvocation.Line.Trim()
    if ($invocationLine -match '^\$.*\s*=\s*' -or $MyInvocation.PipelineLength -gt 1) {
        $isResultCaptured = $true
    }

    # 如果结果被捕获，手动用Write-Host显示结果（否则返回值会被默认输出）
    if ($isResultCaptured) {
        Write-Host "=== 计算结果 ==="
        Write-Host $result
    }

    # 返回结果到输出通道
    return $result
}

效果测试 #

1. 赋值调用（结果被捕获）：

   $Result = Write-OutAndReturn { 1 + 1 }
   

   控制台输出：

   === 输入信息 ===
   执行的脚本块: 1 + 1
   === 计算结果 ===
   2
   

   变量$Result的值为2，符合预期。

2. 直接调用（结果未被捕获）：

   Write-OutAndReturn { 1 + 1 }
   

   控制台输出：

   === 输入信息 ===
   执行的脚本块: 1 + 1
   2
   

   没有重复输出，同时结果仍可通过$LASTEXITCODE之外的方式捕获（比如后续赋值$Result = Write-OutAndReturn {1+1}）。

原理说明 #

• 当结果被赋值或管道到其他命令时，PowerShell会捕获函数的返回值，不会默认输出到控制台，因此我们需要用Write-Host手动显示结果。
• 当直接调用时，PowerShell会自动将返回值输出到控制台，因此我们跳过Write-Host的结果输出，避免重复。
• 调用行的正则匹配和管道长度判断，覆盖了绝大多数常见的结果捕获场景，语义清晰且简洁。

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