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

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

开源代码

GitCode: gitcode.com/xuri/excelize
中文文档: xuri.me/excelize/zh-hans

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

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

兼容性提示

  • 升级 Go 语言版本要求至 1.24.0 或更高版本,以升级依赖包 golang.org/x/crypto

新增功能

  • 新增导出的错误变量 ErrTransparency
  • 新增 3 项数据类型:ChartDashTypeCustomPropertyZipWriter
  • ChartMarker 数据类型中新增 Border 字段
  • ChartLegend 数据类型中新增 Font 字段
  • ChartSeries 数据类型中新增 Legend 字段
  • Fill 数据类型中新增 Transparency 字段
  • ChartLine 数据类型中新增 DashFill 字段
  • Options 数据类型中新增 TmpDir 字段,支持指定用于创建临时文件的临时目录,相关 issue 2024
  • Font 数据类型中新增 Charset 字段,支持指定字体编码
  • 新增 2 项函数 GetCustomPropsSetCustomProps,支持获取和设置工作簿的自定义属性,相关 issue 2146
  • 新增函数 SetZipWriter,支持设置自定义 ZIP 写入器,相关 issue 2199
  • 在函数 GetMergeCells 中新增可选参数 withoutValues,支持获取合并单元格时忽略读区合并单元格的值
  • 函数 DeleteDataValidation 支持删除扩展列表中的数据验证,并支持通过引用序列数组或空格分隔的引用字符串,对多个单元格范围进行删除,相关 issue 2133
  • 函数 AddChart 支持设置图表的虚线样式和数据点边框类型
  • 函数 AddChart 支持设置图表图例的字体,相关 issue 2169
  • 函数 AddChartAddChartSheet 支持创建 4 种箱体和蜡烛图类型股票图表:最高价-最低价-收盘价、开盘价-最高价-最低价-收盘价、成交量-最高价-最低价-收盘价、成交量-开盘价-最高价-最低价-收盘价图表
  • 函数 CalcCellValue 支持计算 BAHTTEXT 公式函数
  • 当字体字号小于最小值时,创建样式时将不再使用默认字体大小代替,而是忽略无效的字号设置
  • 支持解析带有伊斯兰历的单元格数字格式
  • 支持为图表和形状设置透明度,相关 issue 2176
  • 新增对以下 8 种语言的数字格式支持:科西嘉语、克罗地亚语、克罗地亚语(拉丁语)、捷克语、丹麦语、迪维希语、荷兰语、不丹语

兼容性提升

  • 设置单元格公式时移除所有前导等号,以提升与 Apple Numbers 的兼容性,相关 issue 2145
  • 在工作簿内部关系部件中为工作表使用相对路径

问题修复

  • 修复 v2.9.1 中引入的问题,修复 ARMv7 架构上构建失败的问题,解决 issue 2132
  • 修复在数字格式解析器解析结果中,数字格式末尾的空白字符丢失问题
  • 修复部分情况下,读取单元格时由于内部索引偏移范围无效导致的 panic 问题,解决 issue 2019 和 2150
  • 修复部分情况下,读取带有不支持的数据透视表缓存源类型时出现的 panic 问题,解决 issue 2161
  • 修复字符验证错误,在字符长度限制检查中将字符作为单个字符计数,解决 issue 2167
  • 修复部分情况下,添加数据透视表后,生成的工作簿在 Mac 版本 Excel 打开时提示文档损坏的问题,解决 issue 2180
  • 修复读取包含藏语数字格式代码的单元格时月份缩写错误的问题
  • 修复读取 1900 年带有特殊日期数字格式的结果与 Excel 不一致的问题,解决 issue 2192

性能优化

  • 获取工作表已用区域函数 GetSheetDimension 采用流式解析,相较于上个正式版本速度最高提升约 95%,内存分配降低约 96%

其他

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

致谢

感谢 Excelize 的所有贡献者,以下是为此版本提交代码的贡献者列表:

  • DengY11 (Yi Deng)
  • JerryLuo-2005
  • aliavd1 (Ali Vatandoost)
  • xiaoq898
  • Now-Shimmer
  • Jameshu0513
  • mengpromax (MengZhongYuan)
  • Leopard31415926
  • hongjr03 (Hong Jiarong)
  • juefeng
  • black-butler
  • Neugls
  • Leo012345678
  • a2659802
  • torotake
  • crush-wu
  • zhuyanhuazhuyanhua
  • shcabin
相关推荐
聆风吟º8 小时前
CANN开源项目深度实践:基于amct-toolkit实现自动化模型量化与精度保障策略
运维·开源·自动化·cann
AskHarries9 小时前
Skills.lc 是什么?为什么我会做(用)这个站
ai编程
子兮曰9 小时前
OpenClaw入门:从零开始搭建你的私有化AI助手
前端·架构·github
冬奇Lab9 小时前
一天一个开源项目(第15篇):MapToPoster - 用代码将城市地图转换为精美的海报设计
python·开源
沈二到不行9 小时前
【22-26】蜉蝣一日、入樊笼尔
程序员·ai编程·全栈
灰子学技术11 小时前
go response.Body.close()导致连接异常处理
开发语言·后端·golang
大大大反派12 小时前
CANN 生态未来展望:统一框架 `CANN Unified` 与开源协同演进
开源
酷酷的崽79812 小时前
CANN 开源生态实战:端到端构建高效文本分类服务
分类·数据挖掘·开源
晚霞的不甘12 小时前
CANN 在工业质检中的亚像素级视觉检测系统设计
人工智能·计算机视觉·架构·开源·视觉检测
爱吃烤鸡翅的酸菜鱼13 小时前
CANN ops-nn激活函数与池化算子深度解析
网络·开源·aigc