在C#后端开发中，生成或解析Excel文件是一个非常高频的业务需求。无论是导出业务数据报表，还是解析用户上传的表格，选择一款合适的操作类库都至关重要。目前.NET生态中最主流的两种解决方案分别是NPOI和EPPlus。这两款类库虽然都能实现Excel的读写，但在底层设计、API风格以及对不同格式版本的支持上各有侧重。
NPOI与EPPlus的核心差异与基础环境搭建
NPOI是Apache POI的.NET移植版本，它最大的特点是支持早期的xls格式（Excel 97-2003）以及较新的xlsx格式。由于底层基于DOM解析，NPOI在读取文件时会将整个工作簿加载到内存中，这使得它在处理小型或中型数据文件时非常方便，但在处理超大文件时可能会面临内存压力。EPPlus则是一款纯.NET编写的类库，它仅支持xlsx格式，但采用了更现代的底层架构，通过流式处理和优化的内存管理，在处理海量数据导出时表现更为出色。
在环境搭建方面，两者都可以通过NuGet包管理器轻松安装。对于NPOI，你需要安装NPOI包；而对于EPPlus，你需要安装EPPlus包。需要注意的是，EPPlus从5.0版本开始采用了新的许可证模型，对于商业应用需要购买授权，而NPOI则完全免费开源。在.NET Core及后续版本中，这两者都能完美跨平台运行，无需在服务器上安装Microsoft Office套件，这极大地简化了部署流程。
下面是使用NPOI创建一个简单Excel工作簿的代码示例。我们将创建一个工作表，并在第一行写入表头数据：
// 引入NPOI相关命名空间
using NPOI.SS.UserModel;
using NPOI.XSSF.UserModel;
using System.IO;
// 创建新的工作簿（xlsx格式）
IWorkbook workbook = new XSSFWorkbook();
// 创建名为Sheet1的工作表
ISheet sheet = workbook.CreateSheet("Sheet1");
// 创建第一行（索引为0）
IRow row = sheet.CreateRow(0);
// 在第一行创建两个单元格并赋值
row.CreateCell(0).SetCellValue("编号");
row.CreateCell(1).SetCellValue("名称");
// 将工作簿写入文件
using (FileStream fs = new FileStream("test_npoi.xlsx", FileMode.Create, FileAccess.Write))
{
workbook.Write(fs);
}使用EPPlus与NPOI读取并解析Excel数据
读取Excel数据是另一个常见场景。NPOI的读取逻辑同样基于DOM模型，通过获取工作表、遍历行和单元格的方式提取数据。这种方式直观易懂，但开发者需要自行处理空行、空单元格以及数据类型转换的边界情况。EPPlus在读取API的设计上更加现代，它支持LINQ语法查询单元格范围，使得数据提取代码更加简洁优雅，尤其适合处理结构化的表格数据。
在处理单元格数据类型时，NPOI要求开发者显式调用相应的方法，比如GetNumericCellValue()或GetDateCellValue()，否则只能拿到字符串形式的数据。EPPlus则提供了更智能的类型推断机制，通过Value属性可以直接获取底层转换好的对象类型，大幅减少了样板代码的编写量。
以下是使用EPPlus读取Excel文件并遍历数据的代码示例。EPPlus的API设计非常符合直觉，通过ExcelRange对象可以快速获取指定区域的数据：
// 引入EPPlus命名空间
using OfficeOpenXml;
using System.IO;
// EPPlus需要在上下文中设置许可证上下文（非商业用途）
ExcelPackage.LicenseContext = LicenseContext.NonCommercial;
// 加载现有的Excel文件
FileInfo fileInfo = new FileInfo("test_epplus.xlsx");
using (ExcelPackage package = new ExcelPackage(fileInfo))
{
// 获取第一个工作表
ExcelWorksheet worksheet = package.Workbook.Worksheets[0];
// 获取工作表中已使用的维度范围
int rowCount = worksheet.Dimension.Rows;
int colCount = worksheet.Dimension.Columns;
// 遍历所有行和列
for (int row = 1; row <= rowCount; row++)
{
for (int col = 1; col <= colCount; col++)
{
// 使用Value属性获取单元格的值，自动处理类型转换
object cellValue = worksheet.Cells[row, col].Value;
System.Console.WriteLine($"行:{row}, 列:{col}, 值:{cellValue}");
}
}
}大数据量导出场景下的性能对比与选型建议
当业务需要导出数万甚至数十万行数据时，类库的内存管理机制就成了决定性因素。NPOI在构建大型工作簿时，由于采用全量DOM模型，内存占用会随着数据量的增加呈线性甚至指数级增长，极易导致服务器内存溢出或进程崩溃。虽然可以通过手动刷新行块或优化单元格样式复用来缓解，但治标不治本。EPPlus在此场景下具有压倒性优势，它内部实现了基于流的写入机制，能够以极低的内存占用完成大体量数据的导出任务。
在样式处理方面，NPOI提供了细粒度的控制，允许开发者精确设置字体、边框、背景色等属性，但API调用较为繁琐，需要创建ICellStyle对象并应用到单元格上。EPPlus则提供了更直观的样式API，支持类似CSS的链式调用风格，开发体验更佳。此外，EPPlus原生支持图表、数据透视表等高级功能，而NPOI在这些高级特性的支持上相对薄弱。
综合来看，如果你的项目需要兼容老旧的xls格式，或者需要完全免费的开源方案，NPOI是首选。如果项目仅针对现代xlsx格式，且存在大数据量导出需求，或者对开发效率有较高要求，EPPlus无疑是更好的选择。在实际架构设计中，也可以考虑将两者结合使用，利用NPOI处理历史数据导入，使用EPPlus负责核心报表的生成与导出。