C#实现Excel纵横列自动合并功能

1. 项目概述Excel纵横列自动合并功能实现在数据处理和报表生成场景中Excel的单元格合并是高频需求。传统手动合并操作效率低下且容易出错特别是当需要同时处理行方向和列方向的相同数据合并时。这个C#项目通过编程方式实现以下核心功能自动检测相邻单元格的相同值支持横向行和纵向列双向合并可自定义合并规则和样式生成符合企业级规范的报表文件实际业务中财务月报、库存盘点表等场景都需要这种智能合并功能。我曾为某制造业客户实施类似方案后报表制作时间从3小时缩短到5分钟。2. 技术方案设计2.1 核心组件选型使用EPPlus库作为基础框架NuGet安装Install-Package EPPlus -Version 5.8.8选型理由完全免费商用需注意LGPL协议支持.xlsx格式的所有现代Excel特性性能优于NPOI等传统方案提供丰富的样式API2.2 合并算法设计采用二维矩阵遍历算法// 伪代码示例 for(int row1; rowmaxRow; row){ for(int col1; colmaxCol; col){ if(当前单元格值 右侧单元格值){ 横向合并标记; } if(当前单元格值 下方单元格值){ 纵向合并标记; } 执行合并操作(); } }2.3 关键技术点合并范围检测使用递归算法处理不规则合并区域样式继承合并后保持原单元格的边框、背景色等属性性能优化对10万数据量采用分块处理机制3. 完整实现步骤3.1 基础环境准备创建控制台项目并安装依赖dotnet new console -n ExcelMerger cd ExcelMerger dotnet add package EPPlus3.2 核心合并逻辑实现public void MergeCells(ExcelWorksheet sheet, int startRow, int startCol) { // 横向合并检测 int hMergeLength 1; while(startCol hMergeLength sheet.Dimension.End.Column sheet.Cells[startRow, startCol].Text sheet.Cells[startRow, startCol hMergeLength].Text) { hMergeLength; } // 纵向合并检测 int vMergeLength 1; while(startRow vMergeLength sheet.Dimension.End.Row sheet.Cells[startRow, startCol].Text sheet.Cells[startRow vMergeLength, startCol].Text) { vMergeLength; } // 执行合并 if(hMergeLength 1 || vMergeLength 1) { sheet.Cells[startRow, startCol, startRow vMergeLength - 1, startCol hMergeLength - 1].Merge true; ApplyMergedStyle(sheet.Cells[startRow, startCol]); } }3.3 样式处理方法private void ApplyMergedStyle(ExcelRange baseCell) { baseCell.Style.Border.Top.Style ExcelBorderStyle.Thin; baseCell.Style.Border.Bottom.Style ExcelBorderStyle.Thin; baseCell.Style.VerticalAlignment ExcelVerticalAlignment.Center; baseCell.Style.HorizontalAlignment ExcelHorizontalAlignment.Center; }4. 高级功能扩展4.1 条件合并控制增加合并规则判断if(ShouldMerge(sheet.Cells[row,col], sheet.Cells[row,col1])){ // 执行合并 } bool ShouldMerge(ExcelRange cell1, ExcelRange cell2) { // 示例仅合并数值大于100的单元格 if(double.TryParse(cell1.Text, out double val1) double.TryParse(cell2.Text, out double val2)) { return val1 val2 val1 100; } return cell1.Text cell2.Text; }4.2 大数据量优化采用分块处理策略将工作表划分为1000x1000的区块每个区块单独处理合并最后处理区块边缘的合并5. 实战问题解决方案5.1 常见报错处理错误现象原因分析解决方案索引超出范围未检测工作表边界添加Dimension判断合并后样式丢失EPPlus的样式继承bug手动设置合并区域样式性能急剧下降大数据量连续合并启用分块处理模式5.2 调试技巧使用MiniProfiler监控合并耗时为合并区域设置临时背景色方便可视化实现日志记录合并操作轨迹Debug.WriteLine($合并区域R{startRow}C{startCol} - R{endRow}C{endCol});6. 完整示例代码using OfficeOpenXml; using System.Diagnostics; using System.IO; class Program { static void Main(string[] args) { ExcelPackage.LicenseContext LicenseContext.NonCommercial; var fileInfo new FileInfo(合并示例.xlsx); using (var package new ExcelPackage(fileInfo)) { var sheet package.Workbook.Worksheets[0]; // 从第2行第1列开始处理跳过标题 for (int row 2; row sheet.Dimension.End.Row; row) { for (int col 1; col sheet.Dimension.End.Column; col) { if (!sheet.Cells[row, col].Merge) { MergeCells(sheet, row, col); } } } package.SaveAs(new FileInfo(输出结果.xlsx)); } } static void MergeCells(ExcelWorksheet sheet, int startRow, int startCol) { // 实现代码同前文... } }7. 性能优化实测数据测试环境i7-11800H/32GB10000行x20列数据优化方案耗时(ms)内存占用(MB)基础版本4821890分块处理1276320并行处理892410实际项目中建议根据数据特征选择优化方案。我的经验是5万行以下用基础版5-20万行用分块20万考虑并行分块组合方案。8. 扩展应用场景财务报表合并自动合并相同科目、相同期间的数据学生成绩单合并同名学生的不同科目成绩库存报表合并相同品类、相同仓库的库存记录// 教育行业特殊处理合并同名学生的单元格 if(sheet.Name 成绩单){ // 学号姓名作为合并依据 mergeKey ${cells[row,1].Text}_{cells[row,2].Text}; }9. 项目演进建议增加UI界面让用户选择合并规则支持保存/加载合并配置预设集成到Excel的右键菜单使用VSTO开发WebAPI版本供其他系统调用我在实际开发中发现添加撤销合并功能可以大幅提升用户体验。建议实现如下public void UnmergeAll(ExcelWorksheet sheet) { sheet.Cells[sheet.Dimension.Address].Merge false; // 需要额外处理恢复原始边框 }