在服务器上用 COM 自动化 Excel 的人，我见过不少。
大多数是在项目 deadline 前夕，一边骂微软，一边硬着头皮写的。"先让它跑起来再说，反正出事再说。"
然后服务器崩了。
不是因为需求复杂，不是因为数据量大，而是因为——在 Windows Server 上跑 Office COM 自动化这件事本身，就是在给自己埋雷。
服务器没装 Office？崩。装了但版本不对？崩。权限配置有问题？崩。并发一高？直接死给你看。
这大概是 .NET 开发者处理 Excel 时最常见的死法。
另一个常见死法是：硬编码 Encoding。GB2312、GBK、UTF-8，谁测试的时候用了哪台机器的 Excel，就只有那台机器能正常打开。换台机器？恭喜你，乱码。
还有一种死法，叫"百万行导出"。DataTable 直接往 Excel 里塞，内存占用随数据量线性增长，导出到一半 OOM，进程直接蒸发。
这三个坑，分别对应了三种最常见的"凑合方案"：COM 自动化、硬编码 Encoding、无流式处理。
实际上，.NET 生态里有一整套成熟解法，早就摆在那儿了——NPOI。
但很多人对它的了解，仅限于"导出 Excel"三个字。这，不是它的问题，是你的信息差。
一 NPOI 是什么
NPOI 是 Apache POI 项目的 .NET 移植版本。
它的核心能力是：在不安装 Office、不依赖 COM 组件的情况下，用纯 .NET 代码读写 Microsoft Office 文件。
支持的格式覆盖了日常开发中最常用的三类：
- Excel
.xls（Excel 97-2003）和 .xlsx（Excel 2007+） - Word
- PowerPoint
项目地址：
https://github.com/nissl-lab/npoi
开源协议 Apache License 2.0，商业可用。
二 为什么值得认真对待
（一）读和写都支持，不只是导出
很多团队只知道 NPOI 能"导出 Excel"，其实它的读能力同样成熟。
你可以用它：
- 读解析用户上传的 Excel 模板，读取数据后校验入库
- 写根据业务数据动态生成报表，支持单元格样式、公式、合并单元格
- 改打开已有文件，修改指定单元格或 Sheet，保留其他格式
尤其是"读"这个场景——用户上传 Excel 模板，系统读取并处理数据——用 NPOI 比用数据库导入工具灵活得多，而且不需要告知用户"请上传 CSV"。
（二）接口设计得体，代码写起来干净
NPOI 的核心设计思路是接口抽象。在 NPOI.SS.UserModel 命名空间下定义了统一接口：
这套接口同时抽象了 .xls（HSSF）和 .xlsx（XSSF）两套实现。
也就是说，你的代码可以写成这样：
IWorkbook workbook = WorkbookFactory.Create("report.xlsx");ISheet sheet = workbook.GetSheetAt(0);IRow row = sheet.GetRow(0);ICell cell = row.GetCell(0);
WorkbookFactory 自动识别格式，代码本身不需要关心是 .xls 还是 .xlsx。
如果你想让代码同时兼容两种格式，只需要一次判断；如果你确定只用一种格式，直接用对应实现性能更好。这种设计，让 NPOI 的上手门槛极低，同时保留了进阶空间。
（三）大数据量导出：SXSSF 让你不再爆内存
这是 NPOI 最有价值、却最被低估的能力。
普通 XSSF 模式写入 Excel，数据量大时内存会持续增长——因为它需要把整个文件结构保留在内存里。
NPOI 提供了 SXSSF（Streaming XSSF） 模式：通过滑动窗口机制，只保留最近 N 行在内存中，超出窗口的行会写入临时文件，最终Flush到磁盘。
usingvar workbook = new SXSSFWorkbook(100); // 窗口大小100行var sheet = workbook.CreateSheet("大数据导出");for (int i = 0; i < 1000000; i++){var row = sheet.CreateRow(i); row.CreateCell(0).SetCellValue($"数据_{i}");// 每100行自动Flush到临时文件}sheet.FlushRows();workbook.Write(new FileStream("output.xlsx", FileMode.Create));
百万行数据导出，内存占用基本恒定。这是官方提供的标准方案，不是 Hack。
（四）跨平台：Linux 和 macOS 都能跑
NPOI 支持以下目标框架：
.NET 8.NET Standard 2.1（.NET Core 3.x / .NET 5+）.NET Standard 2.0.NET Framework 4.0+
也就是说，在 Linux 服务器上用 Docker 跑 NPOI 生成 Excel，完全没问题。
这对需要在 Linux 环境做无头服务（没有图形界面）的团队来说，是刚需。
三 几个真实使用场景
场景一：批量数据导出
用户选中一批订单，导出 Excel 报表——这是最典型的场景。用 NPOI 可以：
用户的 Excel 体验和你在 Windows 上手动做的几乎一样。
场景二：Excel 模板填充
很多业务系统有固定的 Excel 报表模板（表头固定、格式复杂）。用 NPOI 打开模板、填入数据、另存为新文件，比"复制粘贴"稳定得多：
var template = new FileStream("template.xlsx", FileMode.Open, FileAccess.Read);var workbook = new XSSFWorkbook(template);var sheet = workbook.GetSheetAt(0);sheet.GetRow(1).GetCell(2).SetCellValue("填充的数据");// 保存为新文件，模板保持不变
场景三：用户上传 Excel 解析
用户上传一个格式不固定的 Excel，系统读取内容并导入数据库——这是"读"的场景。
NPOI 的强类型接口比直接用 DataTable 读取更安全：可以逐行校验数据类型、捕获格式异常、给出明确的错误提示（"第5行A列应该是数字，你传了文字"）。
四 快速上手
不想看长文的，直接三步走：
第一步：NuGet 安装
dotnet add package NPOI
第二步：创建一个 Excel 文件
using NPOI.SS.UserModel;using NPOI.XSSF.UserModel;var workbook = new XSSFWorkbook();var sheet = workbook.CreateSheet("第一个Sheet");// 创建表头行var headerRow = sheet.CreateRow(0);headerRow.CreateCell(0).SetCellValue("姓名");headerRow.CreateCell(1).SetCellValue("部门");headerRow.CreateCell(2).SetCellValue("入职日期");// 写入数据var dataRow = sheet.CreateRow(1);dataRow.CreateCell(0).SetCellValue("张三");dataRow.CreateCell(1).SetCellValue("技术部");dataRow.CreateCell(2).SetCellValue(new DateTime(2024, 1, 15));// 保存awaitusingvar fs = new FileStream("hello.xlsx", FileMode.Create, FileAccess.Write);workbook.Write(fs);
第三步：打开文件验证
用 Excel 或 WPS 打开生成的 hello.xlsx，表头和数据都在，说明运行正常。
整个过程不到十分钟，包括安装时间。
五 真实评价：要注意什么
说完了优点，说几个实际踩过的坑：
第一，二进制 .doc 和 .ppt 支持较弱。 NPOI 的 scratchpad 目录里有 HWPF（.doc）和 HSLF（.ppt）的实现，但这两个格式的维护状态不如 Excel 和 Word XML 格式（.docx/.pptx）活跃。如果你的业务需要操作旧版二进制 Office 文件，建议明确评估。
第二，公式计算依赖 Excel 环境。 NPOI 可以读取和写入公式，但如果你在 Excel 里设置了一个公式依赖另一个 Sheet，NPOI 本身不会自动重算——需要在 Excel 中打开才会更新结果值（cached value）。这个行为和 Excel 原生一致，但新手容易困惑。
第三，EULA 和维护费用需要关注。 NPOI 从 2.8.0 版本开始在二进制分发中增加了 EULA，明确要求产生营收的组织支付维护费用。具体细节参考项目的 OSMFEULA。开源项目需要可持续运营，这一点值得理解。
六 最后说一句
很多团队在处理 Excel 时有一种"凑合"心态——先用 DataTable 硬转，不行就上 COM 自动化，再不行就买个商业库。
其实在 .NET 生态里，NPOI 早就把这条路走通了。
它是真正经过大量生产环境验证的库——全球无数项目在用，代码开源，文档完整，社区活跃。
花半小时学会它，从此不再为"Excel 导入导出"这类需求失眠。
GitHub：https://github.com/nissl-lab/npoi文档：https://nissl-lab.github.io/npoi/NuGet：dotnet add package NPOI
