PowerShell脚本中长列名'pořadové číslo protokolu'值为空问题排查

一、核心原因排查 #

问题根源大概率是CSV读写环节的编码不匹配，或是列名的隐式转义/编码丢失——尽管其他同类列正常，但该列名的字符组合（空格+特殊字符）在转CSV或读取CSV时出现编码偏差，导致脚本无法匹配到正确列。

二、分模块修改方案 #

1. 处理主数据文件（XLSX转CSV环节） #

若使用Import-Excel模块转CSV，需确保导出时保留原始列名并指定正确编码：

# 读取XLSX时强制保留原始列名，禁止自动清理特殊字符
$xlsxData = Import-Excel -Path "主数据文件.xlsx" -NoHeader:$false -UseCulture
# 导出CSV时指定UTF-8带BOM编码，避免非ASCII字符乱码
$xlsxData | Export-Csv -Path "转换后的.csv" -Encoding UTF8 -NoTypeInformation -Delimiter ";"

若使用COM对象读取XLSX，需直接读取单元格原始值作为列名，避免自动格式化操作。

2. 处理各协议文件（CSV读取+填充模板环节） #

读取CSV时必须与导出编码保持一致，且用双引号包裹列名访问属性：

# 读取CSV时指定UTF8编码，确保列名完整识别
$csvData = Import-Csv -Path "转换后的.csv" -Encoding UTF8 -Delimiter ";"
# 访问目标列时用双引号包裹完整列名，避免PowerShell解析空格/特殊字符出错
foreach ($row in $csvData) {
    $protokolCislo = $row."pořadové číslo protokolu"
    # 填充模板逻辑示例（以Import-Excel为例）
    $templateData = Import-Excel -Path "模板文件.xlsx"
    $templateData | Where-Object { <# 匹配目标行逻辑 #> } | ForEach-Object {
        $_."目标单元格对应列名" = $protokolCislo
    }
    $templateData | Export-Excel -Path "填充后的文件.xlsx" -NoTypeInformation
}

3. 备选方案：强制映射列名 #

若上述方法无效，可在读取XLSX阶段直接手动映射列名，绕过CSV转码问题：

$xlsxData = Import-Excel -Path "主数据文件.xlsx" | Select-Object *, @{
    Name = "ProtokolCislo"
    Expression = { $_."pořadové číslo protokolu" }
}
# 后续直接用$row.ProtokolCislo访问数据，填充模板

三、关键注意事项 #

• 所有文件读写环节需保持编码统一（推荐UTF8带BOM），避免非ASCII字符转码丢失。
• 访问含特殊字符/空格的列名时，必须用双引号包裹（$row."列名"），不能直接写$row.列名。
• 若用COM对象操作Excel，需读取Range.Value而非Range.Text作为列名，避免格式转换导致的列名偏差。

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