使用NPOI库可高效读写Excel文件，无需安装Office软件。1. 通过NuGet安装NPOI包，支持.NET多版本；2. 读取Excel时，根据.xlsx格式创建XSSFWorkbook，遍历工作表行与单元格，结合CellType解析不同数据类型；3. 写入Excel时，新建工作簿与工作表，设置单元格值并保存至文件流；4. 注意区分.xls和.xlsx对应的不同类，妥善管理文件流释放，处理合并单元格及样式设置。NPOI适用于服务器端批量导入导出场景，功能强大且稳定。
C#操作Excel文件常用的方式是使用NPOI库，它是一个开源的.NET库，可以读写Microsoft Office格式文件，包括Excel（.xls和.xlsx）。相比Office Interop，NPOI无需安装Excel软件，性能更好，适合在服务器端处理表格数据。
1. 安装NPOI库
在项目中使用NuGet包管理器安装NPOI：
Install-Package NPOI支持 .NET Framework 和 .NET Core/.NET 5+ 项目。
2. 使用NPOI读取Excel文件
以下代码演示如何读取一个Excel文件中的数据：
示例：读取第一个工作表的所有单元格内容
using NPOI.SS.UserModel;using NPOI.XSSF.UserModel;
using System.IO;
string filePath = "test.xlsx";
using (FileStream fs = new FileStream(filePath, FileMode.Open, FileAccess.Read))
{
IWorkbook workbook = new XSSFWorkbook(fs); // .xlsx 文件
ISheet sheet = workbook.GetSheetAt(0); // 获取第一个工作表
for (int i = sheet.FirstRowNum; i
{
IRow row = sheet.GetRow(i);
if (row == null) continue;
for (int j = row.FirstCellNum; j
{
ICell cell = row.GetCell(j);
if (cell != null)
Console.Write(GetCellValue(cell) + "\t");
}
Console.WriteLine();
}
}
// 辅助方法：获取单元格实际值
static string GetCellValue(ICell cell)
{
return cell.CellType switch
{
CellType.String => cell.StringCellValue,
CellType.Numeric => cell.NumericCellValue.ToString(),
CellType.Boolean => cell.BooleanCellValue.ToString(),
CellType.Formula => cell.CellFormula,
_ => ""
};
}
3. 使用NPOI写入Excel文件
创建一个新的Excel文件并写入数据：
using NPOI.XSSF.UserModel;using NPOI.SS.UserModel;
using System.IO;
using (IWorkbook workbook = new XSSFWorkbook())
{
ISheet sheet = workbook.CreateSheet("Sheet1");
// 创建第一行
IRow headerRow = sheet.CreateRow(0);
headerRow.CreateCell(0).SetCellValue("姓名");
headerRow.CreateCell(1).SetCellValue("年龄");
headerRow.CreateCell(2).SetCellValue("城市");
// 添加数据行
IRow dataRow = sheet.CreateRow(1);
dataRow.CreateCell(0).SetCellValue("张三");
dataRow.CreateCell(1).SetCellValue(28);
dataRow.CreateCell(2).SetCellValue("北京");
// 保存到文件
using (FileStream fs = new FileStream("output.xlsx", FileMode.Create, FileAccess.Write))
{
workbook.Write(fs);
}
}
Console.WriteLine("Excel文件已生成。");
4. 注意事项与常见问题
区分.xls和.xlsx格式：
- .xlsx（Excel 2007+）使用 XSSFWorkbook
- .xls（旧版）使用 HSSFWorkbook
文件流必须正确释放：
使用 using 语句确保 FileStream 和 Workbook 被及时释放，避免文件被占用。
处理合并单元格：
可通过 sheet.NumMergedRegions 和 sheet.GetMergedRegion() 获取合并区域信息。
设置单元格样式（可选）：
NPOI支持字体、颜色、对齐方式等样式设置，通过 ICellStyle 实现。
基本上就这些。NPOI功能强大，适合大多数Excel导入导出场景，比如从Excel批量导入数据到数据库，或导出报表。掌握基本读写后，可进一步探索公式、图表、图片等高级功能。不复杂但容易忽略细节，比如单元格类型判断和流的管理。
