npoi

项目地址： https://github.com/nissl-lab/npoi

NuGet： NPOI

官方文档： https://github.com/nissl-lab/npoi/wiki

许可证： Apache-2.0

注意： 自 NPOI 2.8.0（2026-04）起，产生收入的商业用户需通过 GitHub Sponsors 支付月度维护费用。详见 NPOI GitHub。

概述

NPOI 主要能力：

• xls（HSSF） / xlsx（XSSF） / 流式 xlsx（SXSSF） 读写
• 公式计算：FormulaEvaluator
• 样式：字体、边框、对齐、数据格式、条件格式
• 图表 / 图片 / 批注
• Word .doc（HWPF） / Word .docx（XWPF）
• PowerPoint .ppt/.pptx
• 跨平台：.NET Framework / .NET 6+ / Linux / macOS

大文件写入推荐 SXSSF（流式），可处理百万行 Excel；大文件读取推荐 EventModel（XSSF SAX）。

---

安装

dotnet add package NPOI

主要命名空间：

• NPOI.HSSF.UserModel — xls
• NPOI.XSSF.UserModel — xlsx
• NPOI.XSSF.Streaming — 流式 xlsx
• NPOI.SS.UserModel — 通用接口（IWorkbook / ISheet / IRow / ICell）
• NPOI.SS.Util — CellRangeAddress、WorkbookUtil

---

写入 Excel（xlsx）

using NPOI.SS.UserModel;
using NPOI.XSSF.UserModel;

IWorkbook wb = new XSSFWorkbook();
ISheet sh = wb.CreateSheet("Sheet1");

// 标题样式
ICellStyle headStyle = wb.CreateCellStyle();
IFont font = wb.CreateFont();
font.Boldweight = (short)FontBoldWeight.Bold; font.FontHeightInPoints = 12;
headStyle.SetFont(font);
headStyle.FillForegroundColor = IndexedColors.Grey25Percent.Index;
headStyle.FillPattern = FillPattern.SolidForeground;
headStyle.Alignment = HorizontalAlignment.Center;

string[] head = { "ID", "Name", "Score", "Time" };
IRow row = sh.CreateRow(0);
for (int i = 0; i < head.Length; i++) {
    var c = row.CreateCell(i);
    c.SetCellValue(head[i]);
    c.CellStyle = headStyle;
}

// 数据
for (int r = 1; r <= 10; r++) {
    var dr = sh.CreateRow(r);
    dr.CreateCell(0).SetCellValue(r);
    dr.CreateCell(1).SetCellValue("User" + r);
    dr.CreateCell(2).SetCellValue(80 + r);
    dr.CreateCell(3).SetCellValue(DateTime.Now);   // 注意要设置日期样式
}

// 列宽
sh.AutoSizeColumn(1);

using var fs = new FileStream("out.xlsx", FileMode.Create);
wb.Write(fs, leaveOpen: false);