如何用PowerShell的Import-Excel模块读取仅含表头的Excel工作表？

问题原因 #

Import-Excel在读取只有表头、无数据行的工作表时，会返回$null，而非包含表头结构的空集合，导致无法通过$xlsx[0]获取表头属性，进而写入新文件时丢失表头。

解决方案1：直接用EPPlus读取表头并生成空数据行 #

借助Import-Excel依赖的EPPlus库直接操作Excel，绕过工具本身的限制：

# 加载EPPlus组件（Import-Excel模块已包含该库）
Add-Type -Path (Join-Path (Get-Module ImportExcel).ModuleBase 'EPPlus.dll')

$sourcePath = 'D:\data.xlsx'
$sheetName = 'events'
$outputPath = 'D:\new_data.xlsx'

# 打开源Excel文件
$excelPackage = [OfficeOpenXml.ExcelPackage]::new((Get-Item $sourcePath))
$targetSheet = $excelPackage.Workbook.Worksheets[$sheetName]

# 提取第一行的表头内容
$headerCells = $targetSheet.Cells[1, 1..$targetSheet.Dimension.End.Column]
$headers = $headerCells.Value | ForEach-Object { $_ }

# 构建带表头的空对象
$emptyDataSet = @()
if ($headers) {
    $emptyObj = New-Object PSObject
    foreach ($header in $headers) {
        $emptyObj | Add-Member -MemberType NoteProperty -Name $header -Value $null
    }
    $emptyDataSet += $emptyObj
}

# 将空数据集写入新Excel文件（-Force覆盖现有文件，-ClearSheet清空目标工作表原有内容）
$emptyDataSet | Export-Excel -Path $outputPath -WorksheetName $sheetName -Force -ClearSheet

# 释放文件资源
$excelPackage.Dispose()

解决方案2：检查Import-Excel返回值并手动补全表头 #

如果不想直接操作EPPlus，可以先判断Import-Excel的返回结果，为空时手动读取表头构建结构：

$xlsxData = Import-Excel 'D:\data.xlsx' -WorksheetName 'events'

if (-not $xlsxData) {
    # 直接读取表头信息
    $tempPackage = [OfficeOpenXml.ExcelPackage]::new((Get-Item 'D:\data.xlsx'))
    $tempSheet = $tempPackage.Workbook.Worksheets['events']
    $headers = 1..$tempSheet.Dimension.End.Column | ForEach-Object { $tempSheet.Cells[1, $_].Text }
    $tempPackage.Dispose()

    # 创建包含表头的空对象
    $emptyObj = [PSCustomObject]@{}
    foreach ($h in $headers) {
        $emptyObj | Add-Member -NotePropertyName $h -NotePropertyValue $null
    }
    $xlsxData = @($emptyObj)
}

# 正常写入新文件
$xlsxData | Export-Excel 'D:\new_data.xlsx' -WorksheetName 'events' -Force -ClearSheet

关键提示 #

• 仅含表头的工作表无法通过Import-Excel直接获取表头结构，必须手动读取表头并构建带属性的空对象，才能让Export-Excel正确生成表头行。
• 直接操作EPPlus时，务必调用Dispose()释放文件资源，避免文件被占用无法编辑。

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