C#如何生成Excel报表_C#使用NPOI操作Excel不安装Office【源码】-C#.Net教程-PHP中文网

应优先使用NPOI而非Microsoft.Office.Interop.Excel，因其不依赖Office安装、无COM交互、线程安全、支持.NET Core+，且避免“CLSID {00024500-...} failed”等典型报错。

c#如何生成excel报表_c#使用npoi操作excel不安装office【源码】

为什么直接用 `NPOI` 而不是 `Microsoft.Office.Interop.Excel`

因为后者必须在目标机器上安装 Office，且多线程下极不稳定，容易卡死或抛出 COMException。而 NPOI 是纯 .NET 实现，不依赖 Office、无 COM 交互、支持 .NET Core/.NET 5+，适合服务端导出场景。

常见错误现象：Retrieving the COM class factory for component with CLSID {00024500-0000-0000-C000-000000000046} failed —— 这是 Interop 在无 Office 环境下的典型报错，NPOI 完全避开这个问题。

仅需引用 NPOI NuGet 包（推荐 NPOI 2.7.1 或更高，注意区分 net48 和 net6.0 版本）
不需注册 COM 组件，也不需要设置 Excel 进程权限
生成的是标准 .xlsx（XSSFWorkbook）或旧版 .xls（HSSFWorkbook），但建议统一用 XSSFWorkbook

`XSSFWorkbook` 创建空工作簿并写入数据的最小可行代码

别一上来就套模板，先跑通最简流程：新建工作簿 → 添加 Sheet → 写入几行数据 → 保存为文件。

using NPOI.XSSF.UserModel;
using NPOI.SS.UserModel;
using System.IO;

var workbook = new XSSFWorkbook();
var sheet = workbook.CreateSheet("报表");

// 写入表头
var headerRow = sheet.CreateRow(0);
headerRow.CreateCell(0).SetCellValue("ID");
headerRow.CreateCell(1).SetCellValue("姓名");
headerRow.CreateCell(2).SetCellValue("金额");

// 写入数据行
var dataRow = sheet.CreateRow(1);
dataRow.CreateCell(0).SetCellValue(1001);
dataRow.CreateCell(1).SetCellValue("张三");
dataRow.CreateCell(2).SetCellValue(999.5);

// 保存到文件
using var fs = new FileStream("report.xlsx", FileMode.Create);
workbook.Write(fs);

关键点：workbook.Write() 必须在 FileStream 打开状态下调用；若提前关闭流，会抛 ObjectDisposedException。

不要用 File.WriteAllText 或 StreamWriter 处理 Excel 文件 —— 它们只适用于文本
如果要写入大量数据（如万行以上），避免反复调用 CreateRow + CreateCell，可缓存 IRow 和 ICell 引用减少对象创建开销
XSSFWorkbook 默认使用 OOXML 格式，兼容 Excel 2007+，不支持 Excel 97–2003 的 .xls

如何设置单元格样式（字体、边框、数字格式）

没有样式的数据报表很难被业务方接受。NPOI 的样式必须通过 ICellStyle 设置，且样式对象不能跨 Sheet 复用（除非显式克隆）。

var font = workbook.CreateFont();
font.FontHeightInPoints = 10;
font.Boldweight = (short)FontBoldWeight.Bold;

var style = workbook.CreateCellStyle();
style.SetFont(font);
style.BorderTop = BorderStyle.Thin;
style.BorderBottom = BorderStyle.Thin;
style.BorderLeft = BorderStyle.Thin;
style.BorderRight = BorderStyle.Thin;

// 应用到某单元格
headerRow.GetCell(0).CellStyle = style;

常见坑：CellStyle 是 workbook 级别资源，最多支持 64000 种唯一样式；若循环中每次都 workbook.CreateCellStyle()，会快速耗尽并抛 InvalidOperationException。

image-to-excel

从图像中提取表格内容，获取行/列数据，修正识别错误，并生成格式规范的 Excel 文件。

下载

复用已有样式：先用 workbook.FindCellFormat(...) 尝试查找匹配样式
数字格式如金额，用 style.DataFormat = workbook.CreateDataFormat().GetFormat("#,##0.00")
中文乱码？确保字体设为 font.FontName = "微软雅黑"（Windows）或 "SimSun"，否则默认 Arial 不支持中文

导出 DataTable 到 Excel 的实用封装要点

实际项目里基本不会手写每行数据，而是从 DataTable 导出。但要注意列类型映射、NULL 值处理、日期格式兼容性。

核心逻辑就是遍历 DataTable.Columns 写表头，再遍历 Rows 写数据行，但必须区分类型：

DBNull.Value 或 null → 跳过 SetCellValue，或设为空字符串（cell.SetCellValue("")）
DateTime → 用 cell.SetCellValue((DateTime)value)（NPOI 会自动识别并序列化），别转成字符串，否则 Excel 无法识别为日期
double/decimal → 直接 SetCellValue(double)，避免 ToString() 后丢失精度或格式错乱
布尔值 → cell.SetCellValue(bool)，Excel 中显示为 TRUE/FALSE，且可参与筛选