FastReport适合WinForms/ASP.NET Core报表，NPOI适合纯数据Excel生成，MiniExcel适合超大文件；选错工具易致返工。
FastReport 是当前 C# 项目中集成成本最低、上手最快的成熟报表方案，尤其适合 WinForms 和 ASP.NET Core 后端导出场景；NPOI 更适合纯数据填充、无样式逻辑的 Excel 批量生成；MiniExcel 则在超大文件读写和内存敏感场景下优势明显——选错工具会导致后续大量返工。
FastReport 初始化失败常见报错与绕过方式
最常卡在 FastReport.Utils.Config.WebMode = false 之后仍报“Could not load file or assembly 'FastReport'”——这基本是平台架构不匹配或 NuGet 版本混用导致。
- 检查项目属性 → “生成”选项卡 → “目标平台”是否为
x64或Any CPU，若引用的是 x86 版 FastReport.dll，必须强制设为x86 - 禁用自动绑定重定向：右键项目 → “属性” → “应用程序” → 取消勾选“启用 ClickOnce 安全设置”和“生成应用程序清单”
- 手动清理
bin/Debug下残留的旧版FastReport*.dll，再重新生成 - 若用的是
FastReport.OpenSource，注意它不支持导出 Word/HTML，商业功能（如图表、脚本）需换回FastReport.Net
NPOI 创建单元格前必须调用 CreateRow 和 CreateCell
新手最容易写的错误代码是直接对 sheet.GetRow(0).GetCell(1) 赋值，结果抛出 NullReferenceException——因为 NPOI 不允许操作空行/空单元格容器。
- 必须先确保行存在：
IRow row = sheet.GetRow(0) ?? sheet.CreateRow(0) - 再确保单元格存在：
ICell cell = row.GetCell(1) ?? row.CreateCell(1) - 对
.xls（HSSFWorkbook）和.xlsx（XSSFWorkbook）使用不同构造函数，混用会触发InvalidOperationException - 批量写入时，避免在循环内反复调用
CreateRow；建议先缓存IRow引用，再复用CreateCell
MiniExcel 读取 Excel 时字段名大小写敏感且不自动 Trim
用 MiniExcel.Query 映射实体类时，若 Excel 表头是 "UserName"，而类属性叫 username，默认不会绑定；更隐蔽的问题是表头带空格（如 " ID "）会导致整列数据为 null。
- 显式指定列映射：
MiniExcel.Query(path, useHeaderRow: true, headerRowIndex: 0, ignoreEmptyRow: true) - 预处理表头：用
MiniExcel.GetSheetNames(path)获取所有 Sheet 名，再用MiniExcel.GetColumnNames(path, sheetName: "Sheet1")检查实际列名 - 实体类字段加
[Column("User Name")]特性可精确匹配含空格/特殊字符的表头 - 不支持合并单元格读取——遇到跨行合并的标题行，MiniExcel 会跳过该行或读成空值，此时应换 NPOI 或预处理 Excel
真正容易被忽略的是数据源连接方式：FastReport 的 DataSource 属性接受 IEnumerable，但若传入未执行的 IQueryable（比如 EF 的 DbSet），会在渲染时报 ObjectDisposedException——因为报表引擎内部多次枚举，而上下文已被释放。务必提前调用 .ToList() 或 .AsEnumerable()。
