PowerShell函数返回对象异常：Excel数据读取后计数不符问题排查

我来帮你分析这个问题的原因并给出修复方案：

问题根源 #

你的函数返回值里混入了未被捕获的COM方法输出，导致最终的$ExcelData不是你预期的仅包含邮件数据的数组，而是包含了额外的对象，所以计数从1变成了4。

具体来说，PowerShell中很多Excel COM对象的方法（比如Workbook.Close()和Excel.Quit()）会返回默认输出，如果你没有把这些输出重定向到$null，它们会被自动加入到函数的返回结果中，和你预期的$Rows数组合并到一起，最终导致计数错误。

另外还有一个潜在问题：当数组只有一个元素时，PowerShell会自动"解包"数组返回单个对象，但你的情况是计数变大，所以核心原因还是额外输出的混入。

修复后的代码 #

下面是修正后的函数，我标记了关键的修改点：

function ExtractExcelRows {
    [cmdletbinding()]
    Param($ExcelFile)
    # Excel.exe not autokill fix
    $before = Get-Process | % { $_.Id }
    $excel = New-Object -ComObject Excel.Application
    $excelId = Get-Process excel | % { $_.Id } | ? { $before -notcontains $_ }
    $workbook = $excel.Workbooks.Open($ExcelFile.FullName)
    $sheet = $workbook.Worksheets.Item(1)
    $excel.Visible = $false
    $rowMax = ($sheet.UsedRange.Rows).Count
    # Declare the starting positions
    $rowEmail, $colEmail = 1, 11
    $Rows = @()
    for ($i=1; $i -le $rowMax-1; $i++) {
        if ($sheet.Cells.Item($rowEmail+$i, $colEmail).Text) {
            $Rows += @{ Email = $sheet.Cells.Item($rowEmail+$i, $colEmail).Text }
        }
    }
    # 关键修改1：压制Close方法的输出，避免混入返回值
    $null = $workbook.Close($false)
    # 关键修改2：压制Quit方法的输出，避免混入返回值
    $null = $excel.Quit()
    Stop-Process -Id $excelId -Force
    Write-Host $Rows.Count # count 1 row ! right!
    # 关键修改3：强制包装为数组，确保返回的始终是数组类型
    return @($Rows)
}

额外优化建议 #

用+=往数组里添加元素的效率很低（每次都会创建新数组），如果处理的行数较多，建议改用ArrayList来存储数据：

# 替换原来的$Rows = @()
$Rows = New-Object System.Collections.ArrayList

# 替换循环里的$Rows += ...
[void]$Rows.Add(@{ Email = $sheet.Cells.Item($rowEmail+$i, $colEmail).Text })

这样可以大幅提升大数量数据的处理效率。

现在再调用你的函数，$ExcelData.Count就会和函数内部的计数一致了。

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