使用C# NPOI库读取Excel文件，核心在于通过FileStream打开文件流，实例化HSSFWorkbook或XSSFWorkbook对象，并遍历Sheet获取Row和Cell数据，这是处理本地Excel文件最稳定且无需安装Office的开源方案。
在数据驱动的时代，企业每天都在处理海量的Excel报表，从财务对账到销售统计，Excel依然是职场中最通用的数据载体，当我们需要自动化处理这些文件时，依赖Office COM组件往往会导致服务器崩溃或权限冲突，NPOI作为Apache POI的.NET移植版，因其轻量、免费且无需安装Microsoft Office即可运行，成为了C#开发者处理Excel文件的首选工具，它支持.xls和.xlsx两种主流格式，能够精准读取单元格内容、样式甚至图片,极大地提升了后端数据处理的效率。
为什么选择NPOI进行Excel读取？
许多开发者在初期面临技术选型时，常在NPOI、EPPlus和ClosedXML之间犹豫，业内专家指出，NPOI在兼容性和底层控制力上具有独特优势，NPOI支持旧版的.xls格式（基于BIFF8）和新版的.xlsx格式（基于OOXML），这意味着它能兼容几乎所有历史遗留系统，相比之下，部分新兴库仅支持新版格式,导致在对接老旧ERP系统时出现兼容性问题。
NPOI完全基于C#编写，不依赖任何第三方COM组件，在Windows Server环境下，如果未安装Microsoft Office，使用COM组件操作Excel会抛出“未注册类”错误，而NPOI则能直接通过文件流读取数据，部署更加简单，NPOI是开源免费的，遵循Apache License 2.0协议，这对于预算有限的中小企业或需要避免版权纠纷的商业项目来说,极具吸引力。
NPOI与EPPlus的性能对比
在读取大规模数据时，性能是关键考量因素，EPPlus在写入方面表现优异，但在读取方面，NPOI的资源占用更为可控，据行业共识认为，在处理超过10万行数据的Excel文件时，NPOI通过流式读取机制，能够有效避免内存溢出（OOM）问题，虽然EPPlus也提供了流式读取接口，但NPOI的实现更为直观,开发者只需关注Row和Cell的迭代即可。
| 特性维度 | NPOI | EPPlus | ClosedXML |
|---|---|---|---|
| 支持格式 | .xls, .xlsx | .xlsx (v4+), .xls (旧版需License) | .xlsx |
| 依赖Office | 否 | 否 | 否 |
| 开源协议 | Apache 2.0 | MIT | MIT |
| 内存占用 | 中等（流式优化好） | 较低 | 较高 |
| 社区活跃度 | 高，文档丰富 | 高 | 中 |
实操指南：C# NPOI读取Excel的具体步骤
要成功实现Excel读取，首先需要确保项目中已安装NPOI NuGet包，在Visual Studio中，可以通过包管理器控制台执行Install-Package NPOI命令，或者在NuGet包管理器中搜索并安装，安装完成后,即可开始编写读取逻辑。
第一步：初始化工作簿对象
读取Excel的第一步是建立文件与程序的连接，根据文件格式的不同，需要实例化不同的Workbook对象，对于.xls文件，使用HSSFWorkbook；对于.xlsx文件，使用XSSFWorkbook，为了代码的通用性，建议使用WorkbookFactory.Create方法,它会自动识别文件类型并返回相应的Workbook实例。
using (FileStream fs = new FileStream("data.xlsx", FileMode.Open, FileAccess.Read))
{
IWorkbook workbook = WorkbookFactory.Create(fs);
// 后续处理逻辑
}
第二步：遍历Sheet和Row
获取Workbook后，下一步是定位到具体的Sheet，Excel文件可能包含多个Sheet，通常第一个Sheet索引为0，通过workbook.GetSheetAt(0)或workbook.GetSheet("SheetName")即可获取目标Sheet，随后，遍历Sheet中的每一行，使用row.GetCell(columnIndex)获取单元格数据。
需要注意的是，Excel中的单元格可能为空，或者包含不同类型的数据（文本、数字、日期、布尔值），直接调用cell.ToString()可能会导致类型转换异常,因此必须进行类型判断。
安全读取单元格数据的技巧
在遍历单元格时，建议封装一个辅助方法，统一处理不同数据类型，对于日期类型，NPOI会返回一个DateTime对象；对于数字，返回double，通过cell.CellType属性判断单元格类型，再调用相应的ToString()或DateCellValue方法,可以确保数据的准确性。
private static string GetCellValue(ICell cell)
{
if (cell == null) return string.Empty;
switch (cell.CellType)
{
case CellType.String:
return cell.StringCellValue;
case CellType.Numeric:
if (DateUtil.IsCellDateFormatted(cell))
return cell.DateCellValue.ToString("yyyy-MM-dd");
return cell.NumericCellValue.ToString();
case CellType.Boolean:
return cell.BooleanCellValue.ToString();
case CellType.Blank:
return string.Empty;
default:
return string.Empty;
}
}
常见场景与问题解决
在实际开发中，开发者经常会遇到一些棘手的问题，读取大文件时的内存溢出，或者特殊字符导致的乱码，针对这些问题,NPOI提供了一些有效的解决方案。
大文件读取优化
当Excel文件行数超过几十万行时，将整个文件加载到内存中会导致内存压力巨大，建议使用SXSSFWorkbook（仅限写入）或流式读取模式，对于读取场景，NPOI的
XSSFReader可以提供基于事件模型的读取方式，类似于SAX解析XML，只加载当前行到内存，处理完即释放，这种方式虽然代码复杂度稍高，但能显著降低内存占用,适合处理GB级别的Excel文件。
乱码与格式丢失处理
部分Excel文件可能包含特殊的编码或隐藏字符，导致读取后出现乱码，确保文件流以正确的编码打开，通常UTF-8是通用选择，如果Excel中使用了合并单元格，NPOI默认只返回左上角单元格的值，其他合并单元格返回null，开发者需要在代码中额外判断合并区域，手动填充合并单元格的值,以确保数据完整性。
Q&A：关于C# NPOI读取Excel的常见问题
C# NPOI读取Excel中文乱码怎么解决？
中文乱码通常由文件编码或字体缺失引起，确保Excel文件本身保存为UTF-8编码，或者在读取时使用正确的编码流，检查服务器环境是否安装了支持中文的字体，如果问题依旧，可能是Excel文件内部使用了非标准编码，此时可尝试使用Microsoft Office打开并另存为UTF-8编码的.xlsx文件,再重新读取。
NPOI读取Excel性能如何，适合大数据量吗？
NPOI在读取中小型Excel文件（如几万行以内）时性能表现良好，足以满足大多数业务需求，对于超大数据量，建议采用流式读取或分批处理策略，通过只读取需要的列和数据行，避免全量加载，可以显著提升处理速度，使用异步IO操作可以进一步减少阻塞时间,提升整体吞吐量。
C# NPOI读取Excel与Office COM组件相比有哪些优势？
NPOI无需安装Microsoft Office，部署简单，避免了COM组件的权限问题和版本依赖，在服务器环境中，NPOI更加稳定，不会因Office未安装或许可证过期而报错，NPOI是纯C#实现，跨平台兼容性更好，可以在Linux环境下通过Mono或.NET Core运行,而COM组件仅支持Windows系统。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/c-npoi%e8%af%bb%e5%8f%96excel%e6%8a%a5%e9%94%99%e6%80%8e%e4%b9%88%e5%8a%9e%ef%bc%8cc-npoi%e8%af%bb%e5%8f%96excel%e6%95%99%e7%a8%8b/
