excelize v2.10.1发布:全新图表数据点、性能翻倍优化、超细致功能更新与Bug修复一览

2026年2月25日，Excelize迎来 v2.10.1 最新版本 正式发布。本次版本不仅带来了多个全新功能点和性能优化，还修复了大量问题，进一步提升了稳定性与易用性。以下是本次版本的详细更新内容。

🌟重大变更（Breaking Change）

在本次版本中，移除了三个导出的错误变量：

• • ErrStreamSetColStyle
• • ErrStreamSetColWidth
• • ErrStreamSetPanes

这意味着在代码迁移时，需注意原有错误变量的调整。

💡亮点功能（Notable Features）

1. 全新数据类型与字段支持

• • 新增 ChartDataPoint 数据类型
• • 新增 ChartSeries 中的 DataPoint字段
• • 新增 ChartAxis 中的 DropLines 与 HighLowLines字段
• • 新增 GraphicOptions 中的 Name字段

2. 全新常量与错误变量

• • 新增两个常量：
• • MaxGraphicAltTextLength
• • MaxGraphicNameLength
• • 新增7个导出的错误变量：
• • ErrFillType
• • ErrFillGradientColor
• • ErrFillGradientShading
• • ErrFillPatternColor
• • ErrFillPattern
• • ErrMaxGraphicAltTextLength
• • ErrMaxGraphicNameLength

3. 新增导出函数与增强支持

• • 新增 GetHyperLinkCells 函数，用于获取超链接单元格。
• • 新增 GetSheetProtection 函数，用于获取工作表保护设置。
• • AddComment 函数现在在为已有评论的单元格添加评论时会返回错误。
• • 新增 ICO图片 插入功能。
• • CalcCellValue 函数新增支持公式函数 SORTBY 和 UNIQUE。
• • AddChart 与 AddChartSheet 支持为甜甜圈图、饼图和3D饼图配置数据点颜色。
• • AddChart 支持设置东亚和复杂脚本字体的字体族。
• • AddChart 现支持区域图与折线图的下垂线和高低线。
• • GetPictures 可以返回部分格式化属性。
• • 流式写入器新增 SetColVisible 函数，可设置列的可见性。
• • 流式写入器新增 SetColOutlineLevel 函数，可对列进行分组。
• • AddShape 与 AddSlicer 支持单元格锚点定位。
• • GetSlicers 支持获取单元格锚点定位的切片器。
• • SetConditionalFormat、GetConditionalFormats、UnsetConditionalFormat 支持更多图标集，包括 3三角形、3星形、5方块 等条件格式。
• • UnsetConditionalFormat 现支持删除指定单元格范围内的特定格式规则或数据验证。
• • AddPicture 与 AddPictureFromBytes 支持设置图片名称。
• • AddChart 与 AddShape 支持设置图表和形状的名称与替代文本。
• • AddSlicer 支持设置切片器的替代文本。
• • 新增图形名称与替代文本长度验证；若超出限制会返回错误。
• • 新增 UTF-16感知长度检测与截断支持。

⚙️兼容性提升（Improve the Compatibility）

• • 保存时移除空行，减少生成的工作簿文件大小。

🐞修复内容（Bug Fixes）

• • 修复 v2.10.0 回归问题：GetCellValue 与 GetRows 对空字符串返回共享字符串索引。
• • 修复 GetPivotTables 在某些情况下获取数据透视表时发生的崩溃。
• • 修复读取包含中文月份的数字格式时可能发生的崩溃。
• • 修复在某些情况下打开加密工作簿时的崩溃问题。
• • 修复流式写入器 SetRow 缺失列样式的问题。
• • 修复 GetPictures 未返回部分单元格图片的问题。
• • 修复浅色主题索引溢出导致的工作簿损坏问题。
• • 修复 DeleteDataValidation 在处理无序单元格引用时更新范围错误的问题。
• • 修复 SetConditionalFormat 在设置时间段条件格式时生成损坏工作簿的问题。
• • 修复 CalcCellValue 在某些情况下无法解析引用的问题，通过删除工作表名称中的单引号解决。
• • 修复 NewStyle 使用默认字体或填充时产生重复样式的问题。

⚡性能优化（Performance）

• • CalcCellValue 增加计算缓存，仅处理实际数据范围，大幅提升效率。
• • CalcCellValue 优化 VLOOKUP 公式计算，内存占用与执行时间约减少 50%。
• • GetMergeCells 优化重叠检测和内存使用，提高合并单元格处理速度。
• • 优化数字格式代码的应用过程，使用连分数递推公式进行转换，提高效率与精度。

✅总结

代码地址：github.com/qax-os/excelize

Excelize v2.10.1 是一次实用性与稳定性大幅提升的版本。从图表数据点到条件格式，从流式写入器增强到性能倍增，本次更新几乎涵盖了工作簿操作的每个角落。无论是做报表、生成图表，还是进行复杂公式计算，v2.10.1 都将带来更高效、更稳健的Excel处理体验。