MiniExcel是专为高性能读写与低内存占用设计的轻量级Excel库，不替代NPOI或EPPlus；支持.NET 6+及Framework 4.7.2+，需using MiniExcelLibs;才能调用Query/SaveAs，仅支持.xlsx/.csv，无样式/公式/密码保护功能。
MiniExcel 不是用来“替代 NPOI 或 EPPlus”的通用 Excel 工具，而是专为「高性能读写 + 低内存占用」场景设计的轻量级库。如果你正被大文件卡死、内存爆掉、或只是想用一行代码完成导入导出，那 MiniExcel 就是你要的答案——它不支持复杂样式、不处理图表、也不做条件格式，但读写百万行数据时，MiniExcel.Query 和 MiniExcel.SaveAs 真的够快、够稳、够省。
怎么安装和验证 MiniExcel 是否生效？
安装本身没坑，但验证方式容易被忽略：装完 NuGet 包后，必须加 using MiniExcelLibs; 才能调用核心方法。不加这句，MiniExcel.Query 会直接报“找不到类型或命名空间”。
- 推荐命令（.NET CLI）：
dotnet add package MiniExcel - VS 图形界面搜索 “MiniExcel”，选最新稳定版（截至 2026 年 4 月是 v1.33+）
- 验证是否成功：新建一个
var data = MiniExcel.Query("test.xlsx");，不报错即通过 - 注意：.NET Framework 4.7.2+ 也支持，但 .NET 6+ 是首选，
System.Text.Json兼容性更好，无需额外装Newtonsoft.Json
读 Excel 时该用 Query<T> 还是 Query()？
区别不在“能不能读”，而在“你是否需要强类型约束”和“列名是否固定”。用错会导致空值、类型转换失败、甚至静默丢数据。
-
MiniExcel.Query<User>("data.xlsx")：适合结构明确的业务表，比如员工、订单。类User的属性名必须和 Excel 表头完全一致（或用[ExcelColumnName("姓名")]映射），否则字段为default -
MiniExcel.Query("data.xlsx")：返回dynamic，按列字母（row.A,row.B）或索引（row[0]）访问，适合临时文件、列名含空格/特殊字符、或表头不规范的场景 - 常见错误：
Query<T>中某列在 Excel 里是空字符串或 “N/A”，而 C# 属性是int，会抛InvalidCastException；建议对数值字段用可空类型（int?）或预处理空值
写 Excel 为什么 SaveAs 有时不生成文件？
MiniExcel.SaveAs 默认只写入 .xlsx，且路径必须包含扩展名，否则静默失败——这是最常被忽略的细节。
- 正确写法：
MiniExcel.SaveAs("output.xlsx", dataList)，不是"output"或"output.xls" - 目标目录需有写权限；若路径是相对路径（如
"./exports/data.xlsx"），确保当前工作目录是你预期的位置（调试时可用Directory.GetCurrentDirectory()检查） - 传入的
dataList不能为空集合，否则生成的文件打开会提示“文件已损坏”（实际是合法但无内容的 xlsx，Excel 不认） - 不支持自定义 sheet 名，默认为
Sheet1；如需多 sheet，得用MiniExcel.SaveAs多次调用 + 不同路径，再手动合并（MiniExcel 本身不提供 workbook 级操作）
流式读取大文件时，Query().ToList() 是不是反模式？
是。虽然 Query() 本身是流式，但一旦接 .ToList() 或 .ToArray()，就等于把全部数据加载进内存——和用 NPOI 没本质区别。
- 真正流式处理姿势：用
foreach (var row in MiniExcel.Query("big.xlsx")) { /* 处理单行 */ }，内存占用恒定在几 MB 内 - 如果必须转成集合（比如要 LINQ 查询或分页），优先考虑
IEnumerable<T>延迟执行，而非急切求值 - 百万行以上数据，别用
Query<T>().ToList()直接绑定到 WinForm 的DataGridView.DataSource，会卡 UI；应先分页加载，或用虚拟模式（VirtualMode）
MiniExcel 的边界很清晰：它不做样式、不碰公式、不支持密码保护，也不处理 .xls（仅支持 .xlsx 和 .csv）。如果你的需求越过了这些线，别硬扛——该切 EPPlus 就切，该用数据库中转就中转。它的价值，从来不是“全能”，而是“在关键路径上，把一件事做到极致”。
