使用EPPlus或NPOI库可实现.NET中数据库查询结果导出Excel，EPPlus适用于.xlsx格式，通过DataTable填充数据并写入ExcelPackage；NPOI支持.xls和.xlsx，兼容性更强且免费开源；大数据量时建议分页查询、流式写入或导出CSV以提升性能，Web场景下通过内存流返回文件供下载。
在.NET开发中，将数据库查询结果导出为Excel文件是一个常见的需求，比如用于报表导出、数据分析等场景。实现这一功能并不复杂，关键是选择合适的库并正确组织数据。以下是具体操作方法和步骤。
使用EPPlus库导出查询结果到Excel
EPPlus 是一个功能强大且广泛使用的 .NET 库，支持读写 Excel 2007 及以上版本（.xlsx 格式），非常适合处理从数据库查询出来的数据。
步骤如下：
- 通过 NuGet 安装 EPPlus：在项目中运行 Install-Package EPPlus 命令。
- 执行 SQL 查询获取数据，可以使用 ADO.NET 或 Entity Framework。
- 创建一个 MemoryStream 和 ExcelPackage 实例。
- 将查询结果填充到 DataTable 或 List 对象中。
- 将数据写入 Excel 工作表的单元格。
- 设置响应头，输出文件供用户下载（适用于 Web 应用）。
示例代码（ASP.NET Core 中）：
using OfficeOpenXml;
using System.Data;
public IActionResult ExportToExcel()
{
// 模拟查询结果
var dataTable = new DataTable();
dataTable.Columns.Add("ID", typeof(int));
dataTable.Columns.Add("Name", typeof(string));
dataTable.Rows.Add(1, "张三");
dataTable.Rows.Add(2, "李四");
using (var package = new ExcelPackage())
{
var worksheet = package.Workbook.Worksheets.Add("数据表");
worksheet.Cells["A1"].LoadFromDataTable(dataTable, true);
var stream = new MemoryStream();
package.SaveAs(stream);
stream.Position = 0;
string fileName = "查询结果.xlsx";
return File(stream, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", fileName);
}
}
使用 NPOI 处理兼容性更高的 Excel 导出
如果你需要支持老版本 Excel（.xls）或部署环境限制使用 EPPlus（如非商业用途免费但有许可证注意点），NPOI 是一个优秀的开源替代方案。
特点：
- 完全免费，开源，兼容 .NET Framework 和 .NET Core/5+。
- 支持 xls 和 xlsx 格式。
- API 类似于 Java 的 POI 项目，学习曲线稍陡但功能全面。
基本流程：
- NuGet 安装：Install-Package NPOI
- 创建 HSSFWorkbook（xls）或 XSSFWorkbook（xlsx）对象。
- 添加 Sheet，并逐行写入查询结果。
- 通过 Response 输出文件（Web 场景）或保存到磁盘（桌面应用）。
处理大数据量时的优化建议
当查询结果非常大时（如十万行以上），直接加载到内存可能导致性能问题或内存溢出。
推荐做法：
- 采用分页查询方式，每次读取一部分数据写入 Excel。
- 使用流式写入，避免一次性加载全部数据。
- 考虑生成 CSV 文件作为替代方案，CSV 更轻量，打开速度快，适合纯数据导出。
- 在后台任务中执行导出，通过消息队列通知用户下载完成。
基本上就这些。选择 EPPlus 还是 NPOI 取决于你的项目需求和许可要求，两者都能很好地完成查询结果导出 Excel 的任务。关键在于把数据库数据正确映射到表格结构，并确保用户体验流畅。
