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

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

版本说明

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

兼容性提示

• 升级 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 支持设置和获取工作簿计算属性
• 新增 CultureNameJaJP、CultureNameKoKR 和 CultureNameZhTW 枚举值，用于读取带有日本年号、韩国檀君纪元（檀纪）和民国纪年数字格式的单元格，相关 issue #1885
• 新增 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 和 #2051
• 修复 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%

其他

• Go Modules 依赖模块更新
• 单元测试与文档更新
• 包含阿拉伯语、德语、英语、西班牙语、法语、意大利语、日语、韩语、葡萄牙语、俄语、简体中文和繁体中文的多国语言文档网站更新
• 支持 WebAssembly / JavaScript 的 excelize-wasm NPM 包发布版本更新
• 支持 Python 的 excelize PyPI 包发布版本更新