epplus 必须设置 licensecontext 才能正常运行：非商用需设 excelpackage.licensecontext = licensecontext.noncommercial；商用须购商业许可；工作表索引从1开始，cells[row,col].value 对空单元格返回 null。
EPPlus 是当前 C# 项目里读写 .xlsx 文件最主流的选择，但它不是“开箱即用”——漏设 LicenseContext、路径不存在、单元格类型乱传，都会直接报错或静默失败。
EPPlus 必须设置 LicenseContext 才能正常运行
从 EPPlus 5.0 开始，所有版本都强制要求显式声明许可证上下文。不设就抛 System.InvalidOperationException: "Set the 'LicenseContext' property..."，哪怕只是本地测试。
- 非商业用途（学习、内部工具、个人项目）：必须加
ExcelPackage.LicenseContext = LicenseContext.NonCommercial;，且这行要放在任何ExcelPackage实例创建之前 - 商用项目（部署到客户环境、SaaS 服务、公司正式系统）：必须购买商业许可证，否则法律风险自担；开源版
NonCommercial不等于“可以免费商用” - 这个设置是进程级静态属性，只设一次即可，无需每个文件操作都重复写
读取 Excel 时工作表索引和空单元格的陷阱
package.Workbook.Worksheets[0] 是常见错误写法——EPPlus 的工作表索引从 1 开始，不是 0。用 [0] 会抛 IndexOutOfRangeException；另外，worksheet.Cells[row, col].Value 对空单元格返回 null，不是空字符串。
Excel XLSX Formula Cleanup
下载
诊断并修复涉及公式、命名范围、Power Query 刷新、数据透视表、VBA/宏保存等问题的 Microsoft Excel XLSX 工作簿
- 按名称取表更安全：
package.Workbook.Worksheets["Sheet1"]，返回null时可提前判断 - 遍历范围别硬写
for (int row = 1; row ，要用 <code>worksheet.Dimension?.Rows获取真实行数，否则可能读到大量null - 取值前务必判空：
worksheet.Cells[2, 1].Value?.ToString()，直接调.ToString()在null上会崩 - 日期、数字等类型字段，
.Value返回的是DateTime或double，不是字符串；想转字符串请用.Text属性（它已做格式化）
Save() 和 SaveAs() 失败的三个高频原因
写入 Excel 后调 Save() 报 DirectoryNotFoundException 或 IOException，基本就是下面这几件事没做对。
- 目标路径的父目录必须已存在，EPPlus 不会自动创建多级目录；写入前加
Directory.CreateDirectory(Path.GetDirectoryName(filePath)); - 如果文件正被 Excel 进程打开，
SaveAs()会因文件被占用而抛IOException；开发阶段建议改用GetAsByteArray()写内存流，避免磁盘锁 - 样式、列宽、公式等修改必须在
Save()前完成；一旦package被using释放，再访问worksheet就是ObjectDisposedException
需要支持 .xls 或 .NET Framework 4.8？换 NPOI
EPPlus 完全不支持 Excel 97–2003 的 .xls 格式，也不支持 .NET Framework 4.8（6.x+ 要求 .NET 5+）。这时候只能切 NPOI，但要注意它俩的底层差异比想象中大。
- 读
.xls必须用HSSFWorkbook，读.xlsx必须用XSSFWorkbook；混用会报Invalid header signature -
XSSFWorkbook构造函数接收Stream，但该流不能在 workbook 创建后关闭；推荐用new MemoryStream(byteArray, leaveOpen: true) - NPOI 没有“工作表索引从 1 开始”的约定，
workbook.GetSheetAt(0)是合法的；但创建单元格前必须先获取或新建行：sheet.GetRow(0) ?? sheet.CreateRow(0)
EPPlus 看似简单，但 LicenseContext、索引偏移、空值处理、路径/权限/资源释放这几个点，任一个疏忽都会卡住一整天。别依赖“示例代码能跑通”，得盯住你实际文件的格式、打开状态和部署环境。.
