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 个函数的签名,具体更改详见官网文档中的更新阐明
新增性能
- 新增函数
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)
- jaby
- FlowingSPDG (Shugo Kawamura)
- barismar (Baris Mar Aziz)
- doingNobb (张涛)
- rpoetrap (Rizki Putra)
- huangshaokun
- CHANTXU64 (ChantXu64)
- playGitboy