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)。
开源代码
- GitHub: github.com/xuri/excelize
- Gitee: gitee.com/xurime/excelize
- 中文文档: xuri.me/excelize/zh-hans
2025年10月14日，社区正式发布了 2.10.0 版本，该版本包含了多项新增功能、错误修复和兼容性提升优化。下面是有关该版本更新内容的摘要，此版本中最显著的变化包括：
兼容性提示
- 升级 Go 语言版本要求至 1.24.0 或更高版本，以升级依赖包
golang.org/x/crypto
新增功能
- 新增导出的错误变量
ErrTransparency - 新增 3 项数据类型：
ChartDashType、CustomProperty和ZipWriter - 在
ChartMarker数据类型中新增Border字段 - 在
ChartLegend数据类型中新增Font字段 - 在
ChartSeries数据类型中新增Legend字段 - 在
Fill数据类型中新增Transparency字段 - 在
ChartLine数据类型中新增Dash和Fill字段 - 在
Options数据类型中新增TmpDir字段，支持指定用于创建临时文件的临时目录，相关 issue 2024 - 在
Font数据类型中新增Charset字段，支持指定字体编码 - 新增 2 项函数
GetCustomProps和SetCustomProps，支持获取和设置工作簿的自定义属性，相关 issue 2146 - 新增函数
SetZipWriter，支持设置自定义 ZIP 写入器，相关 issue 2199 - 在函数
GetMergeCells中新增可选参数withoutValues，支持获取合并单元格时忽略读区合并单元格的值 - 函数
DeleteDataValidation支持删除扩展列表中的数据验证，并支持通过引用序列数组或空格分隔的引用字符串，对多个单元格范围进行删除，相关 issue 2133 - 函数
AddChart支持设置图表的虚线样式和数据点边框类型 - 函数
AddChart支持设置图表图例的字体，相关 issue 2169 - 函数
AddChart和AddChartSheet支持创建 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
