PowerShell导入Excel遇重复表头错误的处理方案咨询

嗨，我明白你遇到的问题了——当Import-Excel碰到重复表头时直接跳过整个工作表确实很闹心，尤其是这些重复的表头还不是你需要的那些。别担心，我们可以通过预处理表头的方式来解决这个问题，让脚本继续导入你需要的数据，同时忽略那些重复表头的干扰。

核心思路 #

Import-Excel报错的原因是默认要求表头唯一，我们可以先读取工作表的第一行（表头行），给重复的表头添加后缀（比如_1、_2），然后用处理后的表头作为-HeaderName参数传入，这样就能绕过重复表头的校验，顺利导入数据，之后再按你的需求提取$expectedColumns里的列即可。

修改后的脚本片段（替换原try块内的导入逻辑） #

把你原脚本中try块里的$sheetData = Import-Excel ...部分替换成以下代码：

try {
    # 第一步：读取原始表头行，处理重复表头
    $originalHeaders = Import-Excel -Path $excelFile.FullName -WorksheetName $sheetName -NoHeader -Range "1:1" | Select-Object -First 1
    $processedHeaders = @()
    $headerOccurrence = @{}

    foreach ($header in $originalHeaders.PSObject.Properties.Value) {
        if ($headerOccurrence.ContainsKey($header)) {
            # 给重复表头添加序号后缀
            $headerOccurrence[$header]++
            $processedHeaders += "$header`_$($headerOccurrence[$header])"
        } else {
            $headerOccurrence[$header] = 1
            $processedHeaders += $header
        }
    }

    # 第二步：使用处理后的表头导入数据
    $sheetData = Import-Excel -Path $excelFile.FullName -WorksheetName $sheetName -HeaderName $processedHeaders -ErrorAction Stop

    # 后续你的原有逻辑（创建自定义对象、提取需要的列）保持不变
    foreach ($row in $sheetData) {
        $customObject = [PSCustomObject]@{
            'File' = $excelFile.Name
            'Sheet' = $sheetName
        }

        foreach ($column in $expectedColumns) {
            $columnNameLower = $column.ToLower()
            $customObject | Add-Member -MemberType NoteProperty -Name $column -Value $row.($columnNameLower)
        }

        $allData += $customObject
    }
} catch {
    Write-Warning "Error importing data from sheet '$sheetName' in file '$($excelFile.FullName)': $_"
}

为什么这样有效？ #

1. 我们先通过-NoHeader参数读取表头行，避免触发重复表头的校验；
2. 对重复的表头进行重命名（比如原重复表头XXX会变成XXX_1、XXX_2），确保所有表头唯一；
3. 用处理后的表头导入数据后，你原来的列匹配逻辑（转小写匹配$expectedColumns）不受影响，因为那些重复的表头本来就不在你需要的列列表里，不会干扰数据提取。

这样修改后，脚本就不会再因为非目标列的重复表头而跳过整个工作表，而是正常导入你需要的数据啦。

备注：内容来源于stack exchange，提问作者Clemson5000