Excelize 发布 2.7.1 版本,Go 语言 Excel 文档基础库

Excelize 是 Go 语言编写的用于操作 Office Excel 文档基础库,基于 ECMA-376,ISO/IEC 29500 国际标准。可以使用它来读取、写入由 Microsoft Excel™ 2007 及以上版本创建的电子表格文档。支持 XLAM / XLSM / XLSX / XLTM / XLTX 等多种文档格式,高度兼容带有样式、图片(表)、透视表、切片器等复杂组件的文档,并提供流式读写 API,用于处理包含大规模数据的工作簿。可应用于各类报表平台、云计算、边缘计算等系统。入选 2020 Gopher China - Go 领域明星开源项目(GSP)、2018 年开源中国码云最有价值开源项目 GVP (Gitee Most Valuable Project),目前已成为 Go 语言最受欢迎的 Excel 文档基础库。

开源代码

GitHub: github.com/xuri/excelize

Gitee: gitee.com/xurime/excelize

中文文档: xuri.me/excelize/zh-hans

2023年4月10日,社区正式发布了 2.7.1 版本,该版本包含了多项新增功能、错误修复和兼容性提升优化。下面是有关该版本更新内容的摘要,完整的更改列表可查看 changelog

此版本中最显著的变化包括:

兼容性提示

  • 移除了 ChartLine 数据类型中的 Color 字段
  • 使用 RichTextRun 数据类型代替 ShapeParagraph
  • 使用 Fill 代替 Shape 数据类型中的 Color 字段
  • 移除了已导出的数据类型 AutoFilterListOptions
  • 将数据类型 TableOptions 重命名为 Table
  • 添加图表函数 AddChart 改为使用 ChartType 类型枚举值指定图表类型
  • 修改了 7 个函数的签名,具体更改详见官方文档中的更新说明

新增功能

  • 新增函数 SetSheetDimensionGetSheetDimension 以支持设置与获取工作表已用区域,相关 issue #1463
  • 创建样式函数 NewStyle 现已支持 17 种渐变填充样式
  • 增加创建样式数量上限至 65430
  • 通过 AddPicture 添加图片时,现已允许插入 BMP 格式图片
  • 函数 GetPictures 支持读取被添加至同一单元格中的多张图片
  • 设置条件格式函数 SetConditionalFormat 支持设置带有“如果为真则停止”和“图标集”条件的条件格式规则
  • 设置条件格式函数 SetConditionalFormat 支持设置在条件格式中使用带有纯色填充样式的数据条,并支持指定数据条的颜色,相关 issue #1462
  • 添加图表函数 AddChart 支持设置图表中各个数据系列使用自定义填充颜色,相关 issue #1474
  • 添加图表函数 AddChart 支持设置气泡图图表中各个系列气泡的大小
  • 添加图表函数 AddChart 支持设置子母饼图和复合条饼图中第二绘图区域的数据系列
  • 添加图表函数 AddChart 支持为图表中数据标签设置自定义数字格式,相关 issue #1499
  • 创建表格函数 AddTable 支持在创建表格时指定是否包含标题行
  • 创建表格函数 AddTable 创建表格时增加对表格名称的校验,并导出了错误常量 ErrTableNameLength,相关 issue #1468
  • 函数 AutoFilter 支持为筛选范围内的多个列设置筛选条件
  • 计算单元格的值函数 CalcCellValue 现已支持指定是否为公式计算结果应用数字格式
  • 计算单元格的值函数 CalcCellValue 对于以下公式函数加入了双字节字符的支持:LEFT, LEN, LENB, MID, MIDB, RIGHT 和 RIGHTB,相关 issue #1476
  • 计算单元格的值函数 CalcCellValue 函数对于存在错误的公式将在计算结果中返回公式错误代码,并将详细错误信息在 error 数据类型的返回值中返回,相关 issue #1490
  • 对输入图片文件的扩展名调整为大小写不敏感,相关 issue #1503
  • 使用流式写入器流式按行赋值时,对于值为 nil 的单元格将会跳过生成该单元格,相关 issue #756
  • 获取超链接 GetCellHyperLink 函数支持读取合并单元格中的超链接
  • 添加了新的导出类型 ChartType 以表示图表类型枚举

兼容性提升

  • 兼容带有函数组的工作簿
  • 兼容带有严格模式 XML 命名空间地址的工作簿主题,相关 issue #1447
  • 提高了与文档内部不含工作簿关系部件工作簿的兼容性,以修复打开此类工作簿可能出现的 panic

问题修复

  • 修复了特定情况下读取日期时间类型单元格的值存在精度误差的问题
  • 修复了特定情况下当修改原本存储了日期时间类型的单元格为文本类型值,修改后单元格数据类型有误的问题,解决 issue #1464
  • 修复了部分情况下公式计算结果为空的问题,解决 issue #1469
  • 修复了设置数据条类型条件格式时,指定自定义最大/最小值无效的问题,解决 issue #1492
  • 修复了打开行高或列宽为 0 的工作表,保存后行高列宽设置失效的问题,解决 issue #1461
  • 提高了读取带有空白字符共享字符串表索引值的兼容性,解决 issue #1508

性能优化

  • 提高了应用带有自定义月份数字格式的速度,相关 issue #1455
  • 大幅提高了对于带有合并单元格工作表的处理速度,相关 issue #1448

其他

  • Go Excelize 提供了支持 WebAssembly / Javascript 环境的 excelize-wasm NPM 包
  • Go Modules 依赖模块更新
  • 单元测试与文档更新
  • 优化内部变量与函数命名
  • 包含简体中文、英语、法语、俄语、日语、韩语、阿拉伯语、德语和西班牙语的多国语言文档网站更新

致谢

感谢 Excelize 的所有贡献者,以下是为此版本提交代码的贡献者列表:

  • liron-l (Liron Levin)
  • nathj07 (Nathan Davies)
  • Josh-Weston (Josh Weston)
  • jaby
  • FlowingSPDG (Shugo Kawamura)
  • barismar (Baris Mar Aziz)
  • doingNobb (张涛)
  • rpoetrap (Rizki Putra)
  • huangshaokun
  • CHANTXU64 (ChantXu64)
  • playGitboy