Excelize 是 Go 语言编写的用于操作 Office Excel 文档类库,基于 ECMA-376 Office Open XML 标准。可以使用它来读取、写入由 Microsoft Excel™ 2007 及以上版本创建的 XLSX 文档。相比较其他的开源类库,Excelize 支持写入原本带有图片(表)、透视表和切片器等复杂样式的文档,还支持向 Excel 文档中插入图片与图表,并且在保存后不会丢失文档原有样式,可以应用于各类报表系统中。入选 2018 开源中国码云 Gitee 最有价值开源项目 GVP,目前已成为 Go 语言最受欢迎的 Excel 文档基础库。
开源代码
GitHub: github.com/xuri/excelize
中文文档: xuri.me/excelize/zh-hans
2019年10月9日,社区正式发布了 2.0.2 版本,该版本包含了多项新增功能、错误修复和兼容性提升优化。
此版本中最显著的变化包括:
兼容性提示
升级至该版本需要您的 Go 语言版本高于 1.10。
新增功能
- 支持创建数据透视表。新增
AddPivotTable()
函数 - 支持创建迷你图 (Sparkine)。 新增
AddSparkline()
函数 - 新增
GroupSheets()
和UngroupSheets()
方法,支持设置工作表分组和取消工作表分组 - 新增
AddVBAProject()
方法,支持向 Excel 文档中嵌入包含函数和宏的 VBA 工程 - 函数
SetPageLayout()
增加适应页面宽高属性支持,相关 issue #432 - 函数
SetSheetViewOptions()
现在支持 “值为零的单元格是否显示零值” 属性的设置 - 函数
SetCellFormula()
增加了对公式类型和引用属性的设置支持 - 增加带有删除线字体样式的创建支持,相关 issue #482
问题修复
- 修复部分情况下读取批注内容文本不完整的问题,解决 issue #434
- 修复由于内部合并单元格偏移量计算错误导致的部分情况下使用
RemoveRow()
删除行出现下标越界问题,解决 issue #437 - 修复部分情况下数据验证下拉菜单中的公式失效问题
- 修复在循环迭代中调用
Save()
方法保存导致的文档损坏问题,解决 issue #443 - 提升文档内部
workbook.xml.rels
中相对路径格式解析的兼容性,解决 issue #442 - 修复部分情况下,删除带有合并单元格的文档所导致的文件损坏问题
- 修复部分情况下设置保护工作表属性失效的情况,解决 issue #454
- 修复部分情况下
GetSheetName
获取工作表名称为空的问题, 解决 issue #457 - 增加单元格内多行文本解析的支持, 相关 issue #464
- 修复 32 位操作系统环境下数字溢出问题,相关 issue #386
- 修复 go module 依赖版本不匹配问题, 相关 issue #466 和 issue #480
- 修复部分情况下调用
SetSheetPrOptions()
所致的文档损坏问题,解决 issue #483
性能表现
- 性能优化,减少读取文档时的内存开销和耗时,相关 issue #439
其他
- 完善
SetSheetRow()
函数中的异常处理 - 代码精简优化, 合并了下列内部函数:
将函数 workBookRelsWriter
, drawingRelsWriter
合并为 relsWriter
;
将函数 drawingRelsReader
, workbookRelsReader
, workSheetRelsReader
合并为 relsReader
;
将函数 addDrawingRelationships
, addSheetRelationships
合并为 addRels