Excelize 开源基础库 2.8.0 版本正式发布
![](https://static001.geekbang.org/infoq/32/327c3fe6452b9ab64321cdb9c9209b23.jpeg?x-oss-process=image%2Fresize%2Cp_80%2Fauto-orient%2C1)
Excelize 是 Go 语言编写的用于操作电子表格办公文档的开源基础库,基于 ISO/IEC 29500、ECMA-376 国际标准。可以使用它来读取、写入由 Microsoft Excel、WPS、Apache OpenOffice、LibreOffice 等办公软件创建的电子表格文档。支持 XLAM / XLSM / XLSX / XLTM / XLTX 等多种文档格式,高度兼容带有样式、图片(表)、透视表、切片器等复杂组件的文档,并提供流式读写支持,用于处理包含大规模数据的工作簿。可应用于各类报表平台、云计算、边缘计算等系统。自 2016 年开源以来已成为云原生应用尤其是 Go 语言开发者在处理电子表格办公文档时的热门选择,正在被广泛应用于大型互联网公司、中小企业客户和初创公司。荣获 2022 年中国开源创新大赛一等奖、入选 2020 Gopher China - Go 领域明星开源项目 (GSP)、2018 年开源中国码云最有价值开源项目 GVP (Gitee Most Valuable Project)。
开源代码
GitHub: github.com/xuri/excelize
Gitee: gitee.com/xurime/excelize
中文文档: xuri.me/excelize/zh-hans
2023 年 8 月 28 日,社区正式发布了 2.8.0 版本,该版本包含了多项新增功能、错误修复和兼容性提升优化。下面是有关该版本更新内容的摘要,完整的更改列表可查看 changelog。
此版本中最显著的变化包括:
兼容性提示
将导出变量
ErrTableNameLength
重命名为ErrNameLength
将导出类型
PaneOptions
重命名为Selection
将导出类型
Comment
中的Runs
字段重命名为Paragraph
移除了
Style
数据类型中的Lang
字段移除了
ChartTitle
数据类型,使用RichTextRun
类型代替更改
DecimalPlaces
字段的数据类型为指针类型修改了默认点与像素单位转换系数,相关 issue #279 和 #1536
修改了
AddShape
函数的签名:将func (f *File) AddShape(sheet, cell string, opts *Shape) error
改为func (f *File) AddShape(sheet string, opts *Shape) error
新增功能
新增导出错误变量
ErrExistsTableName
和ErrorFormControlValue
Options
数据类型中新增ShortDatePattern
,LongDatePattern
,LongTimePattern
和CultureInfo
选项,支持设置长短日期与时间格式代码,相关 issue #1199新增用于表示区域代码的
CultureName
类型枚举新增函数
GetTables
与DeleteTable
支持获取与删除表格,相关 issue #674 和 #1454新增函数
GetStyle
支持获取样式定义,相关 issue #314, #1520 和 #1521支持为单元格的值应用带有占位、对齐、舍入、货币、会计专用和转换选项的数字格式,并支持带有 812 种语言(位置)时间和日期类型的数字格式,相关 issue #660
新增 10 项公式函数: ARRAYTOTEXT, FORECAST, FORECAST.LINEAR, FREQUENCY, INTERCEPT, ODDFYIELD, ODDLPRICE, ODDLYIELD, PROB 和 VALUETOTEXT
增加对工作簿保存路径的检查,若路径长度超出限制将返回错误提示
新增
GetPanes
函数,支持获取窗格和视图选区设置新增 3 项表单控件函数
AddFormControl
、GetFormControls
和DeleteFormControl
, 支持添加主要水平和垂直坐标轴标题,相关 issues #301 和 #1169添加图表函数
AddChart
支持添加主要水平和垂直坐标轴标题,相关 issue #1553添加图表函数
AddChart
支持添加次坐标轴,相关 issue #518添加图表函数
AddChart
支持设置图表富文本标题与图表标题格式,相关 issue #1588通过
AddShape
函数添加形状时,如果给定的形状类型不受支持,将返回异常错误支持读取带有日本年号数字格式的单元格,相关 issue #1590
函数
GetPictures
支持读取带有单一单元格锚点位置的图片,相关 issue #1585函数
NewConditionalStyle
支持创建带有数字格式与保护属性的条件格式样式,相关 issue #1610
兼容性提升
添加对带多字节文本的单元格字符长度检查,相关 issue #1517
当创建带有重复名称的表格或自定义名称时,将返回错误异常
提高单元格批注文本框大小显示效果在 KingSoft WPS 下的兼容性
支持从自定义工作表属性设置中读取列宽度,相关 issue #1536
修改内部工作表 XML 部件名称为大小写不敏感以提高兼容性,相关 issue #1591
问题修复
修复因计算带有转义 XML 单元格的长度有误导致的,部分情况流式生成工作簿损坏问题,解决 issue #1518, #1519 和 #1530
修复带有多行文本的单元格批注文本框大小异常问题
修复了部分情况下,读取带有数字格式的文本单元格时,读取结果有误的问题,解决 issue #1523, #1528 和 #1533
修复了并发安全函数中存在的竞态问题
修复了部分情况下,对与单元格时间毫秒舍入精度结果有误的问题
修复了部分情况下,读取带有 12 小时制数字格式的单元格时,时间结果有误的问题
修复了部分情况下,计算带有 SUMIFS 和 AVERAGEIFS 函数的公式结果有误的问题,解决 issue #1564
修复了公式计算引擎中基本算数运算符优先级问题导致的计算结果有误问题,解决 issue #1599
修复部分情况下,带有跨工作表单元格引用公式计算结果有误的问题
修复部分情况下,删除行后,工作表中的表格调整结果异常的问题,解决 issue #1539
支持读取单元格中的多张图片,解决 issue #1548
修复部分情况下,因读取图形对象位置有误导致的添加图片结果异常问题,解决 issue #1560
删除行列时支持调整公式,修复部分情况下导致的文档损坏问题,解决 issue #1565
修复了部分情况下,计算带有 CONCAT 和 CONCATENATE 函数的公式结果有误的问题,解决 issue #1569
修复部分情况下,带有嵌套数字类型参数公式的计算结果有误问题,解决 issue #1582
修复因内部图形对象计数器有误导致的部分情况下添加图片出现重复的问题,解决 issue #1584
修复因部分情况下读取带有时间类型数字格式的单元格时,小时有误的问题,解决 issue #1587
修复了部分情况下,获取合并单元格区域右下角单元格坐标时出现的 panic
性能优化
优化内部正字表达式的执行速度,相关 issue #1532
避免内部字节数组与字符串数据类型变量之间的转换,相关 issue #1541
其他
Go Modules 依赖模块更新
简化了内部变量的声明与错误返回语句
移除了内部带有 Unicode 编码的预设语言数字格式映射表
移除了内部
xlsxTabColor
数据类型,使用xlsxColor
代替xlsxTabColor
数据类型单元测试与文档更新,单元测试行覆盖度提升 0.24%,达到 98.91%
包含简体中文、英语、法语、俄语、日语、韩语、阿拉伯语、德语和西班牙语的多国语言文档网站更新
版权声明: 本文为 InfoQ 作者【xuri】的原创文章。
原文链接:【http://xie.infoq.cn/article/36846b3cf8a8693ca5f877483】。
本文遵守【CC-BY 4.0】协议,转载请保留原文出处及本版权声明。
评论