(相关资料图)
Excelize 是 Go 语言编写的用于操作 Office Excel 文档基础库,基于 ECMA-376,ISO/IEC 29500 国际标准。可以使用它来读取、写入由 Excel、WPS、OpenOffice 等电子表格办公应用创建的电子表格文档。支持 XLAM / XLSM / XLSX / XLTM / XLTX 等多种文档格式,高度兼容带有样式、图片(表)、透视表、切片器等复杂组件的文档,并提供流式读写 API,用于处理包含大规模数据的工作簿。可应用于各类报表平台、云计算、边缘计算等系统。入选 2020 Gopher China - Go 领域明星开源项目(GSP)、2018 年开源中国码云最有价值开源项目 GVP (Gitee Most Valuable Project),2022 中国开源创新大赛优秀项目。
开源代码
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 个函数的签名,具体更改详见官方文档中的更新说明新增功能
新增函数SetSheetDimension
与 GetSheetDimension
以支持设置与获取工作表已用区域,相关 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)jabyFlowingSPDG (Shugo Kawamura)barismar (Baris Mar Aziz)doingNobb (张涛)rpoetrap (Rizki Putra)huangshaokunCHANTXU64 (ChantXu64)playGitboy