如何用PowerShell的ImportExcel模块在Excel中添加分页符？

方法一：利用ImportExcel底层的EPPlus API实现 #

ImportExcel模块本质封装了EPPlus库，无需安装Excel或依赖COM对象，直接通过获取EPPlus的核心对象就能添加水平分页符。

示例代码 #

# 导入ImportExcel模块
Import-Module ImportExcel

# 模拟多组报表数据
$dataGroups = @(
    @{GroupName = "华东区域"; Data = 1..12 | ForEach-Object { [PSCustomObject]@{门店ID = $_;销售额 = (Get-Random -Min 5000 -Max 20000)} }},
    @{GroupName = "华北区域"; Data = 13..24 | ForEach-Object { [PSCustomObject]@{门店ID = $_;销售额 = (Get-Random -Min 5000 -Max 20000)} }},
    @{GroupName = "华南区域"; Data = 25..36 | ForEach-Object { [PSCustomObject]@{门店ID = $_;销售额 = (Get-Random -Min 5000 -Max 20000)} }}
)

# 指定输出路径
$outputPath = "C:\Reports\RegionalSales.xlsx"

# 创建Excel包并获取工作表
$excelPackage = New-ExcelPackage -Path $outputPath
$worksheet = $excelPackage.Workbook.Worksheets.Add("销售报表")

$currentRow = 1
foreach ($group in $dataGroups) {
    # 写入组标题
    $worksheet.Cells[$currentRow, 1].Value = $group.GroupName
    $worksheet.Cells[$currentRow, 1].Style.Font.Bold = $true
    $currentRow++

    # 写入当前组数据
    $group.Data | Export-Excel -ExcelPackage $excelPackage -WorksheetName "销售报表" -StartRow $currentRow
    $currentRow += $group.Data.Count + 1 # 组间留空行

    # 为非最后一组添加水平分页符
    if ($group -ne $dataGroups[-1]) {
        $worksheet.Row($currentRow).AddPageBreak()
    }
}

# 保存并释放资源
$excelPackage.Save()
$excelPackage.Dispose()

关键说明 #

• $worksheet.Row($行号).AddPageBreak()：EPPlus原生方法，在指定行上方插入水平分页符，Excel打开后会自动在该位置分页。
• 仅依赖ImportExcel模块，无需额外软件支持。

方法二：直接修改Excel的XML结构实现 #

如果需要直接操作Excel底层XML，可利用Excel是ZIP压缩包的特性，修改工作表XML中的分页符节点。

示例代码 #

$excelPath = "C:\Reports\RegionalSales.xlsx"
$tempXmlPath = "C:\Temp\SheetTemp.xml"

# 打开Excel ZIP包
$zipPackage = [System.IO.Packaging.ZipPackage]::Open($excelPath, [System.IO.FileMode]::Open, [System.IO.FileAccess]::ReadWrite)

# 获取第一个工作表的XML部分
$sheetUri = New-Object System.Uri("/xl/worksheets/sheet1.xml", [System.UriKind]::Relative)
$sheetPart = $zipPackage.GetPart($sheetUri)

# 读取XML内容
$streamReader = New-Object System.IO.StreamReader($sheetPart.GetStream())
$xmlContent = $streamReader.ReadToEnd()
$streamReader.Close()

# 解析XML并添加分页符节点
$xmlDoc = [xml]$xmlContent
$rowBreaks = $xmlDoc.CreateElement("rowBreaks")
$rowBreaks.SetAttribute("count", "2")
$rowBreaks.SetAttribute("manualBreakCount", "2")

# 第一个分页符：第14行之后（对应第一组数据结束）
$brk1 = $xmlDoc.CreateElement("brk")
$brk1.SetAttribute("id", "14")
$brk1.SetAttribute("max", "16384")
$brk1.SetAttribute("man", "1")
$rowBreaks.AppendChild($brk1)

# 第二个分页符：第27行之后（对应第二组数据结束）
$brk2 = $xmlDoc.CreateElement("brk")
$brk2.SetAttribute("id", "27")
$brk2.SetAttribute("max", "16384")
$brk2.SetAttribute("man", "1")
$rowBreaks.AppendChild($brk2)

# 将分页符节点插入到XML中（放在sheetPr节点之后）
$sheetPrNode = $xmlDoc.sheet.sheetPr
$xmlDoc.sheet.InsertAfter($rowBreaks, $sheetPrNode)

# 将修改后的XML写回ZIP包
$streamWriter = New-Object System.IO.StreamWriter($sheetPart.GetStream([System.IO.FileMode]::Create, [System.IO.FileAccess]::Write))
$xmlDoc.Save($streamWriter)
$streamWriter.Close()

# 关闭ZIP包
$zipPackage.Close()

关键说明 #

• Excel工作表XML路径为xl/worksheets/sheetN.xml（N为工作表序号）。
• <rowBreaks>节点定义手动分页符，<brk>的id属性对应行索引（从0开始计数，比如id="14"表示在第15行上方分页），man="1"标记为手动分页符。

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