Open xml SDK 通过操作 .xlsx 的 ZIP 结构和 XML 实现无 excel 依赖的轻量高效处理:创建需构建 WorkbookPart 等部件并填充 SheetData;修改需定位 XML 节点更新 CellValue/DataType;数值、日期、公式、样式须严格按规范设置;简单场景推荐 EPPlus/NPOI/ClosedXML。

用 C# 的 Open XML SDK 创建和修改 Excel 文件,核心是操作 .xlsx 的底层 ZIP 结构和 XML 内容,不依赖 Excel 应用程序,轻量、高效、适合服务端批量处理。
创建新 Excel 文件(.xlsx)
新建工作簿本质是生成符合 office Open XML 标准的文件结构:包含 WorkbookPart、WorksheetPart、SharedStringTablePart 等部件。关键步骤如下:
- 用
SpreadsheetDocument.Create()创建空文档,并指定SpreadsheetDocumentType.Workbook - 添加
WorkbookPart,再在其中添加WorksheetPart(每个 Sheet 对应一个) - 手动或通过
SharedStringTablePart管理文本(避免重复存储相同 字符串) - 向
SheetData中逐行添加Row和Cell,注意设置Cell.CellValue和Cell.DataType(如CellValues.String或CellValues.number) - 最后调用
workbook.Save()和document.Close()
小技巧:首次创建时建议先用 Excel 手动保存一个极简模板(1 行 1 列),再用 Open XML SDK Productivity Tool 查看其内部结构,对照 编码 更不容易出错。
修改已有 Excel 文件
打开现有文件用 SpreadsheetDocument.Open(path, true)(true 表示可写)。重点不是“编辑单元格”,而是定位并更新对应 XML 节点:
- 通过
WorkbookPart.Workbook.Sheets找到目标Sheet,再用WorksheetPart获取其Worksheet - 遍历
Worksheet.GetFirstChild<sheetdata>().Elements<row>()</row></sheetdata>定位行,再找Cell(可用cell.CellReference.Value == "A1"匹配) - 修改
cell.CellValue.Text,若类型变化(如从文本改数字),需同步设cell.DataType并处理数值格式 - 如果新增内容超出原
SheetData范围,需手动追加Row和Cell,注意维护行号和列引用(如 “B5″)
注意:直接改 CellValue 不会自动刷新公式结果或样式——Open XML 只管存储,不计算。
写入数值、日期、公式和样式的要点
Open XML 对 数据类型 和格式要求严格,容易踩坑:
- 数值:设
cell.DataType = NULL(默认为数字),cell.CellValue = new CellValue("123.45") - 日期:Excel 内部存为浮点数(从 1900-01-01 起的天数),用
DateTime.ToOADate()转换,且必须设cell.StyleIndex指向带日期格式的CellFormat - 公式:设
cell.CellFormula = new CellFormula("SUM(A1:A10)"),同时设cell.DataType = CellValues.Formula;注意公式值(CellValue)应为上次计算结果(否则 Excel 打开会显示 #VALUE!) - 样式:需提前在
WorkbookPart的WorkbookStylesPart中定义Fonts、Fills、Borders、CellFormats,再通过cell.StyleIndex引用索引
推荐替代方案(简单场景优先考虑)
如果只是读写数据、不涉及复杂样式或公式,Open XML SDK 学习成本高、代码冗长。可考虑:
- EPPlus(.net 5+ 推荐):API 友好,支持公式、图表、样式,开源免费(MIT 协议),用法接近 Excel Interop 但无 COM 依赖
- NPOI:java POI 的 .NET 移植,兼容老版 .xls,社区活跃,文档较全
- ClosedXML:封装 Open XML,语法简洁(如
ws.Cell("A1").Value = "Hello"),适合快速开发
Open XML SDK 最适合需要精细控制文件结构、做深度定制(如加密、自定义 XML 部件)、或构建底层 工具 链的场景。
基本上就这些。用 Open XML SDK 处理 Excel,逻辑清晰但细节多,关键是理解“文件即 ZIP + XML”的本质,动手调试几次结构就顺了。