EPPlus中AddChart后图表不显示数据最常见原因是数据区域引用错误：chart.Series.Add()要求值（Y轴）与分类（X轴）同长度、同起始行且不能跨表，如worksheet.Cells["B2:B13"]需配worksheet.Cells["A2:A13"]，行列错位或首行不齐将导致空白或NullReferenceException。
EPPlus 生成图表不是“调个 API 就完事”，关键在数据源绑定方式、坐标轴映射逻辑和工作表生命周期管理——漏掉任一环，图表就显示为空白或报 NullReferenceException。
为什么 AddChart 后图表不显示数据
最常见原因是数据区域引用错误：EPPlus 的 chart.Series.Add() 要求第一个参数是「值（Y 轴）」，第二个是「分类（X 轴）」，且二者必须同长度、同起始行，不能跨工作表引用。
- 错误写法：
chart.Series.Add(worksheet.Cells["B2:B13"], worksheet.Cells["A1:A12"])（行列不齐、首行错位） - 正确写法：
chart.Series.Add(worksheet.Cells["B2:B13"], worksheet.Cells["A2:A13"])（严格对齐） - 若数据来自动态集合，务必先用
worksheet.Dimension.Address获取真实范围，再构造Cells[...]，避免空行干扰 - 图表对象必须显式添加到工作表的
Drawings集合，仅 new 出来不生效
eChartType 枚举值选错导致渲染失败
不是所有图表类型都支持任意数据结构。例如 eChartType.LineMarkers 强制要求 X 轴为数值型，而你传了字符串列（如月份名），Excel 打开时会静默丢弃图表。
- 时间序列建议用：
eChartType.Line或eChartType.ColumnClustered - 占比分析优先选：
eChartType.Pie或eChartType.BarClustered - 复合图（柱+折线）需用
eChartType.ColumnLineCombo，并分两次调用Add()指定不同系列类型 - .NET 6+ 中
eChartType已支持更多选项，但旧版 EPPlus 4.x 不识别eChartType.Histogram等新枚举，会抛ArgumentException
图表位置与尺寸设置不当引发布局错乱
SetPosition() 和 SetSize() 的单位是「像素」，但其坐标原点是工作表左上角（非窗口），且受 Excel 缩放比例影响；若未固定视图，导出后打开可能偏移或被裁切。
- 推荐用
SetPosition(5, 0, 10, 0)（第 5 行、第 0 列开始，即 E1 单元格左上角）比绝对像素更稳定 - 避免设超大尺寸（如
SetSize(2000, 800)），Excel 客户端可能拒绝渲染，建议上限1200×600 - 调用
SetPosition()前确保目标单元格区域无合并单元格，否则图表会“卡住”无法拖动 - 如需响应式适配，可先用
worksheet.Column(colIndex).Width计算列宽，再换算为像素（1 列 ≈ 72 像素）
导出含图表的 Excel 在服务器环境打不开
这不是代码问题，而是 EPPlus 生成的 .xlsx 文件依赖完整 OPC（Open Packaging Convention）结构，若流未完全写入或响应头缺失，Office Online 或 WPS 会提示“文件损坏”。
- 必须用
package.SaveAs(stream)，禁用Save()（后者写本地磁盘，不适合 Web） - ASP.NET Core 中务必设置：
Response.ContentType = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" - Stream 用完后要
stream.Position = 0，否则前端读取为空 - Linux 服务器上注意时区：若图表含日期轴，
DateTime.Now可能被转成 Excel 不识别的格式，建议统一用DateTime.UtcNow+ 显式格式化
真正难的不是画出图表，而是让图表在任意终端、任意 Office 版本、任意网络条件下都能稳定加载——这意味着你要反复验证 Cells 地址是否越界、eChartType 是否被目标环境支持、以及流输出是否被中间件截断。
