如何阻止PowerShell外部模块返回的数组被连接字符串前置？

问题场景 #

我编写了主脚本调用外部PowerShell模块，模块负责遍历网站列表，在每个页面搜索特定术语，将网站、网页、找到的术语存入数组。模块内打印$resultArray显示结果正常，但主脚本执行$resultArray = SearchPages -sites c:\sites.csv后，数组前被追加了对应站点数量的连接字符串，导致生成CSV文件异常（连接字符串无对应列）。

外部函数代码：

Function searchPages(sites){

$sitelist=Get-Sites

foreach($site in $sitelist)
{
  $page = GetPageContent
  If (KeywordFound)
  {
    $outputData = Get-OutputData $page
    $listMatches = SetMatchData  -searchcontent -url -outputData
    $resultArray += listMatches
  }
}
return $resultArray 
}

主脚本调用代码：

$resultArray = SearchPages -sites c:\sites.csv

原因分析 #

PowerShell函数会默认收集所有未被捕获的命令输出，作为返回结果的一部分。你的函数中存在以下可能的问题：

• Get-Sites、GetPageContent等内部函数可能有未被捕获的冗余输出（比如命令执行时的状态信息、调试输出）
• 未显式初始化$resultArray，第一次赋值时若遇到非数组类型的输出，会触发字符串拼接逻辑
• KeywordFound这类判断函数如果返回布尔值的同时还输出其他内容，这些内容会被追加到返回结果中

这些冗余输出会和你最后return $resultArray的内容合并，导致主脚本接收到的数组前多出额外的连接字符串。

解决方法 #

1. 显式初始化结果数组 #

在函数开头明确初始化数组，避免类型异常：

$resultArray = @()

2. 抑制所有冗余输出 #

对不需要返回值的命令，用Out-Null或[void]抑制输出：

# 方式1：用Out-Null
$sitelist = Get-Sites | Out-Null
# 方式2：用[void]
[void]$page = GetPageContent

3. 检查内部函数的输出 #

确保Get-Sites、KeywordFound等内部函数仅返回必要值，无额外输出。比如KeywordFound应只返回布尔值，不要输出调试信息或其他内容。

修正后的函数示例 #

Function SearchPages {
    param(
        [string]$sites
    )
    # 显式初始化结果数组
    $resultArray = @()
    # 获取站点列表，确保无冗余输出
    $sitelist = Get-Sites -Path $sites

    foreach($site in $sitelist)
    {
        # 获取页面内容，抑制冗余输出
        $page = GetPageContent -Site $site | Out-Null
        # 检查关键词，确保仅返回布尔值
        if (KeywordFound -Page $page)
        {
            $outputData = Get-OutputData -Page $page
            $listMatches = SetMatchData -searchcontent $page -url $site.Url -outputData $outputData
            $resultArray += $listMatches
        }
    }
    return $resultArray 
}

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