c#如何操作Excel_c#操作Excel快速上手实战教程

用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 手动撸节点。