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

qZ6bgMe43

264人浏览 · 2026-03-25 15:37:16

qZ6bgMe43 · 2026-03-25 15:37:16 发布

兼容性提示

移除了 3 个导出的错误变量：ErrStreamSetColStyle、ErrStreamSetColWidth 和 ErrStreamSetPanes

新增功能

新增 ChartDataPoint 数据类型
在 ChartSeries 数据类型中新增 DataPoint 字段
在 ChartAxis 数据类型中新增 DropLines 和 HighLowLines 字段
在 GraphicOptions 数据类型中新增 Name 字段
在 ChartSeries 数据类型中新增 DataPoint 字段
新增 2 个常量：MaxGraphicAltTextLength 和 MaxGraphicNameLength
新增 7 个导出的错误变量：ErrFillType、ErrFillGradientColor、ErrFillGradientShading、ErrFillPatternColor、ErrFillPattern、ErrMaxGraphicAltTextLength 和 ErrMaxGraphicNameLength
新增 GetHyperLinkCells 函数，支持获取包含超链接的单元格，相关 issue 1607
新增 GetSheetProtection 函数，支持获取工作表保护设置
当向已存在批注的单元格添加批注时，AddComment 函数将返回错误
支持插入 ICO 格式图片，相关 issue 2234
新增 2 项公式函数：SORTBY 和 UNIQUE
添加图表时支持为圆环图、饼图和三维饼图设置数据点颜色，相关 issue 1904
添加图表时支持为东亚文字与复杂文字脚本设置字体
添加图表时支持为面积图和折线图设置下垂线与高低线
获取图片时支持返回部分图片格式属性，相关 issue 2157
新增流式设置列可见性功能，相关 issue 2075
新增流式设置列的分级显示功能，相关 issue 2212
添加形状和添加切片器时，支持将形状与切片器设置为单一单元格锚定类型
获取切片器时支持获取单一单元格锚定类型的切片器
支持设置与获取“3 个三角形”、“3 颗星”和“5 个方框”类型的图标集条件格式，相关 issue 2038
删除条件格式和删除数据验证时，支持从一个大的单元格范围中删除指定单元格范围内的条件格式或数据验证，而保留其余单元格范围内的条件格式或数据验证
添加图片时支持设置图片的名称
添加图表或插入形状时，支持为图表或形状设置名称与替代文本
添加切片器时支持为切片器设置替代文本
支持校验图形名称与替代文本的长度，当长度超过限制时将会返回错误
支持以 UTF-16 方式检查并截断文本长度

兼容性提升

保存工作簿时将自动移除无效的空行，减少生成的工作簿文件大小

问题修复

修复 v2.10.0 中引入的问题，解决 GetCellValue 与 GetRows 函数在某些情况下读取空白单元格时，错误地返回了共享字符串索引，相关 issue 2240
修复 GetPivotTables 函数在部分情况下获取数据透视表时发生 panic 的问题
修复部分情况下，读取带有中文月份名称数字格式的单元格时，发生 panic 的问题，相关 issue 2224
修复部分情况下，打开带有密码保护的加密工作簿时，发生 panic 的问题，相关 issue 2237
修复使用流式写入器 SetRow 函数时，列样式缺失的问题
修复获取图片时，未包含部分单元格图片的问题
修复由浅色主题颜色索引溢出导致的，部分情况下生成的工作簿损坏的问题
修复删除数据验证函数 DeleteDataValidation 在数据验证单元格范围无序时，数据验证单元格范围未被正确更新的问题
修复设置条件格式函数 SetConditionalFormat 在设置部分带有时间周期条件格式规则时，生成的工作簿损坏的问题
修复计算单元格的值时，对带有单引号的工作表名称解析失败，导致的单元格公式计算结果有误问题
修复使用默认字体或填充格式创建样式时，重复创建样式的问题，相关 issue 2254