Excelize 开源基础库发布 2.9.1 版本更新

Excelize 开源基础库 2.9.1 版本发布, 2025 年首个更新

Excelize 是 Go 语言编写的用于操作 Office Excel 文档基础库，基于 ECMA-376，ISO/IEC 29500 国际标准。可以使用它来读取、写入由 Excel、WPS、OpenOffice 等办公软件创建的电子表格文档。支持 XLAM / XLSM / XLSX / XLTM / XLTX 等多种文档格式，高度兼容带有样式、图片(表)、透视表、切片器等复杂组件的文档，并提供流式读写支持，用于处理包含大规模数据的工作簿。可应用于各类报表平台、云计算、边缘计算等系统。自 2016 年开源以来已成为云原生应用尤其是 Go 语言开发者在处理电子表格办公文档时的热门选择，正在被广泛应用于大型互联网公司、中小企业客户和初创公司。入选 2023 开源创新榜优秀开源项目、荣获 2022 年中国开源创新大赛一等奖、2020 Gopher China - Go 领域明星开源项目 (GSP)、2018 年开源中国码云最有价值开源项目 GVP (Gitee Most Valuable Project)。

开源代码

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

2025年5月13日，社区正式发布了 2.9.1 版本，该版本包含了多项新增功能、错误修复和兼容性提升优化。下面是有关该版本更新内容的摘要，此版本中最显著的变化包括：

版本说明

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

兼容性提示

升级 Go 语言版本要求至 1.23 或更高版本，以升级依赖包 golang.org/x/crypto
将 DataValidationType、DataValidationErrorStyle、DataValidationOperator、PictureInsertType 的数据类型由 int 变更为 byte
函数 SetCellInt 的形参类型改为 int64，解决 issue 2068
添加图片、图表、形状和表单控件等绘图对象时，偏移设置将不再影响绘图对象的尺寸，解决 issue 2001

新增功能

在 Chart 数据类型中新增 GapWidth 和 Overlap 字段
在 ChartPlotArea 数据类型中新增 ShowDataTable 和 ShowDataTableKeys 字段
在 ChartAxis 数据类型中新增 Alignment 字段
在 ChartSeries 数据类型中新增 DataLabel 字段
在 PageLayoutOptions 数据类型中新增 PageOrder 字段
新增 2 项错误变量：ErrPageSetupAdjustTo 和 ErrStreamSetColStyle
新增 2 项枚举类型：HeaderFooterImagePositionType 和 IgnoredErrorsType
新增 2 项数据类型：CalcPropsOptions 和 HeaderFooterImageOptions
新增 2 项函数 SetCalcProps 和 GetCalcProps 支持设置和获取工作簿计算属性
新增 AddHeaderFooterImage 函数，支持在页眉和页脚中设置图片，相关 issue 1395
新增 AddIgnoredErrors 函数，支持忽略特定单元格范围内的错误，相关 issue 2046
新增 SetColStyle 函数，支持流式写入时设置列样式，相关 issue 2075
函数 AddChart 和 AddChartSheet 支持设置图表坐标轴文本方向和旋转角度，相关 issue 2025
函数 AddChart 和 AddChartSheet 支持设置柱状图和条形图的间隙宽度和重叠程度，相关 issue 2033
函数 AddChart 和 AddChartSheet 支持设置数据系列标签的格式，相关 issue 2052
函数 AddChart 和 AddChartSheet 支持设置位于图表绘图区域下方的数据表，相关 issue 2117
函数 AddFormControl 函数支持为复选框类型的表单控件设置单元格超链接，相关 issue 2113
函数 SetPageLayout 支持设置页面布局的页面顺序
函数 DeletePicture 支持删除带有单一单元格锚定类型的图片，相关 issue 2059
函数 SetPageLayout 增加了对选项参数的检查，如果给定的选项值无效，将返回错误提示信息
支持跨多个工作表调整数据验证，相关 issue 2072
支持应用带 # 号和零占位符的数字格式，相关 issue 2058
支持应用带 ? 符号的数字格式
支持通过指定 “oneCell” 定位类型添加带有单一单元格锚定类型的绘图对象，相关 issue 2002

问题修复

修复 v2.9.0 中引入的问题，修改由流式写入生成的工作簿后，打开后提示文档损坏问题，解决 issue 2015
修复部分情况下生成重复的“无填充”格式问题，解决 issue 2014
修复部分情况下单元格垂直或水平边框样式丢失问题，解决 issue 2048
修复部分情况下条件格式边框样式丢失的问题，解决 issue 2061
修复部分情况下获取数据透视表时出现 panic 的问题，解决 issue 1954
修复 GetStyle 函数无法获取 VertAlign 格式的问题
修复 CalcCellValue 函数在部分情况下子表达式计算错误的问题，解决 issue 2083
修复部分情况下因图片引用检查有误导致的错误删除图片问题
修复流式写入时，非零行样式 ID 未覆盖默认单元格样式的问题
修复流式写入时，部分情况下将在工作簿内部生成重复的 col XML 元素问题
修复部分情况下设置图表标题字体时出现的 panic 问题，解决 issue 2102
修复部分情况下删除公式计算链时出现的 panic 问题
修复因共享公式解析错误导致的公式计算结果有误问题，解决 issue 2056
修复当工作簿内部包含大于 4GB 的部件时，生成的 ZIP64 格式文档损坏问题
修复当部分情况下重命名工作表时，自定义名称中的工作表名称更新有误的问题，解决 issue 2126

性能优化

使用深拷贝库 github.com/tiendc/go-deepcopy 代替 github.com/mohae/deepcopy，深度拷贝速度提升 3 倍，相关 issue 2029
修复 v2.9.0 中引入的问题，避免对空白单元格的值进行修剪以降低内存分配
提高公式计算引擎对带有整行或整列单元格引用公式的计算速度
行迭代器读取速度最高提升约 20%，内存分配降低约 10%