PowerShell合并列结构不同的CSV文件报错，求错误解析及解决

错误含义 #

这个错误的核心是你要合并的两个CSV列结构完全不匹配：第一个CSV包含Name、ID、Phone三列，第二个只有Address、Location两列。

PowerShell的Export-Csv -Append默认要求追加的对象必须包含目标CSV已有的所有列，同时目标CSV的列也要匹配追加对象的列。第一次导出后，merged.csv的列是Name、ID、Phone；第二次尝试追加第二个CSV时，这些对象没有任何已存在的列，所以PowerShell拒绝执行，脚本中断，最终导致合并文件为空（可能是因为第一次写入的内容被中断操作影响，或者原始CSV本身为空）。

解决方案 #

方案1：强制追加（不推荐） #

如果只是想强行合并，忽略列不匹配的问题，可以给Export-Csv加上-Force参数，缺失的列会留空，多余的列会被添加：

$dir = ".\csvs"

foreach ($csv in (Get-ChildItem "$dir\*.csv"))
{
    Import-Csv $csv | Export-Csv .\merged.csv -NoTypeInformation -Append -Force
}

但这种方式会导致行数据错位，可读性很差。

方案2：规范合并所有列（推荐） #

先收集所有CSV的列名，给每个行数据补充缺失的列，确保所有对象结构一致后再导出：

$dir = ".\csvs"
# 读取所有CSV数据
$allCsvData = Get-ChildItem "$dir\*.csv" | ForEach-Object { Import-Csv $_.FullName }

# 获取所有唯一列名
$allColumns = $allCsvData | ForEach-Object { $_.PSObject.Properties.Name } | Select-Object -Unique

# 处理每行数据，补充缺失列
$mergedRows = $allCsvData | ForEach-Object {
    $currentRow = $_
    $outputRow = [ordered]@{}
    foreach ($col in $allColumns) {
        $outputRow[$col] = $currentRow.$col
    }
    [PSCustomObject]$outputRow
}

# 导出合并结果
$mergedRows | Export-Csv .\merged.csv -NoTypeInformation

这个脚本会生成包含所有列的CSV，每行数据只填充自己有的列值，其他列留空，结构规范。

合并文件为空的排查方向 #

• 检查.\csvs目录下的两个原始CSV是否本身为空
• 确认脚本运行时有写入当前目录merged.csv的权限
• 验证Get-ChildItem "$dir\*.csv"是否能正确找到目标CSV文件（可以单独运行该命令查看结果）

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