用EPPlus操作Excel，很多人第一反应是装个NuGet包就开干，结果一运行就报错——不是代码不行，是版本没选对。这套库其实挺成熟，但坑也藏在细节里：版本兼容、空值处理、动态范围、ContentType……今天咱们把几个常见问题一次性说清楚。
EPPlus读写Excel需按.NET版本选型：.NET Framework用4.5.3.1，.NET 5+用6.2+；注意空值处理、动态范围读取、ContentType设置及边界场景限制。
用 EPPlus 读写 Excel 最省事，但 NuGet 包版本得选对
新版 EPPlus（5.7+）默认要求 .NET 5+，如果你还在用 .NET Framework 4.7.2 或更老版本，装最新版会直接报错：Could not load file or assembly 'System.Text.Encodings.Web'。这不是你代码有问题，是包不兼容。
- 老项目（
.NET Framework）请固定安装EPPlus 4.5.3.1：Install-Package EPPlus -Version 4.5.3.1 .NET 6/7/8项目推荐用EPPlus 6.2+，它原生支持stream操作，不用临时文件- 别碰
Microsoft.Office.Interop.Excel—— 它依赖本地 Office 安装，服务器上必挂，且线程不安全
LoadFromCollection 写数据快，但空值和类型要提前处理
用 worksheet.Cells["A1"].LoadFromCollection(dataList) 确实三行搞定导出，但它对 null 和混合类型很敏感：遇到 null 字段会写成字符串 "null"；如果列表里有 DateTime? 和 string 混着来，Excel 单元格格式可能全乱，数字被当文本。
- 导出前统一做空值映射：
item.Property ?? string.Empty或用Convert.ToString() - 避免自动推断类型：显式设置列格式，比如
worksheet.Column(2).Style.Numberformat.Format = "yyyy-mm-dd" - 如果数据含公式或特殊字符（如换行符
\n），记得开自动换行：worksheet.Cells["A1:A100"].Style.WrapText = true
读 Excel 时 worksheet.Cells 范围别硬写 "A1:Z1000"
很多人图省事写死范围，结果实际数据只到第 50 行，后面全是空行 —— Cells["A1:Z1000"] 会把所有单元格都加载进内存，哪怕内容为空，GC 压力大，读取慢 3–5 倍。
- 用
worksheet.Dimension动态获取真实范围：var range = worksheet.Cells[worksheet.Dimension.Address] - 如果首行是标题，读数据从第 2 行开始：
for (int row = 2; row - 跳过空行判断别只看 A 列：
range.Rows[row].Any(c => !string.IsNullOrWhiteSpace(c.Text))
保存文件时别漏掉 ContentType，否则浏览器下载打不开
Web 场景下用 package.Sa veAs(stream) 返回 Excel，但 ASP.NET Core 默认给的 Content-Type 是 application/octet-stream，Chrome 会把它当二进制乱码处理，点开是空白或报“文件已损坏”。
- 必须手动设响应头：
Response.ContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" - 文件名带中文？用
Content-Disposition的filename*=格式，不然 IE/Edge 会乱码 - 流用完别忘了
stream.Position = 0，否则前端读不到内容
真正麻烦的不是读写逻辑，是边界场景：空工作表、合并单元格、密码保护文件、共享公式 —— 这些 EPPlus 支持有限，遇到就得切回 OpenXML SDK 手动撸节点。
