Excelize 2.7.0 发布, 2023 年首个更新|工作簿|工作表

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

开源代码

https://github.com/xuri/excelize

中文文档

https://xuri.me/excelize/zh-hans

更新摘要

2023年1月9日，社区正式发布了 2.7.0 版本，该版本包含了多项新增功能、错误修复和兼容性提升优化。此版本中最显著的变化包括：

兼容性提示

升级至该版本需要您使用的 Go 语言为 1.16 或更高版本，以迁移不再支持的标准库ioutil
当给定工作表名称中存在无效字符时将返回错误，不再自动忽略无效字符
GetCellStyle函数不再返回合并单元格区域左上角单元格的样式
重命名以下 5 个导出数据类型和错误常量，具体更改详见官方文档中的更新说明
移除了 54 项导出类型，具体更改详见官方文档中的更新说明
移除了 2 个导出常量：OrientationPortrait和OrientationLandscape
修改了以下 21 个函数的签名，使用结构体引用代替此前以 JSON 格式表示的选项参数，具体更改详见官方文档中的更新说明
引入了 8 项新的函数代替现有函数，具体更改详见官方文档中的更新说明
在CellType枚举值中添加CellTypeFormula,CellTypeInlineString,CellTypeSharedString并移除了CellTypeString
对添加批注AddComment函数的签名进行了更改，支持创建富文本批注，相关 issue #1204
当 XML 反序列化异常时将返回错误以代替输出日志，函数GetComments,GetDefaultFont和SetDefaultFont增加了 error 类型的错误返回值

新增功能

新增GetDataValidations和GetConditionalFormats函数以支持获取数据验证设置和条件格式，相关 issue #827
新增ProtectWorkbook和UnprotectWorkbook以提供工作簿保护设置支持
新增SetSheetCol函数以支持按列设置单元格的值，相关 issue #1247
新增GetColStyle函数以支持设置列样式，相关 issue #1293
新增SetSheetBackgroundFromBytes函数以支持根据给定的图片数据设置工作表背景图片，相关 issue #1405
新增导出变量IndexedColorMapping以支持内建索引颜色转换
新增 20 项导出类型:AutoFilterListOptions,AutoFilterOptions,Chart,ChartAxis,ChartDimension,ChartLegend,ChartLine,ChartMarker,ChartPlotArea,ChartSeries,ChartTitle,ConditionalFormatOptions,PaneOptions,Panes,GraphicOptions,Shape,ShapeColor,ShapeLine,ShapeParagraph和TableOptions
新增 2 项公式函数: AGGREGATE 和 SUBTOTAL
Save、Write和WriteTo函数支持指定保存选项，相关 issue #744
使用AddChart函数添加图表时，支持为折线图设置是否使用平滑折线，相关 issue #1290
使用AddChart函数添加图表时，支持设置自定义折线图线条颜色，相关 issue #1345
使用AddChart函数添加图表时，支持设置自定义坐标轴字体样式，相关 issue #320
添加图表函数AddChart支持创建三维折线图
以下函数新增并发安全支持：SetColWidth、GetColWidth、SetColVisible、GetColVisible、SetColStyle和GetColStyle
设置样式时，当给定的样式 ID 不存在时将返回错误，相关 issue #1323
流式按行赋值时，若行号未递增将返回错误，以避免生成的工作簿损坏，相关 issue #1139
按行流式写入工作表时，支持通过指定RowOpts为单元格设置样式，相关 issue #1354
支持流式设置窗格，相关 issue #1047
支持流式设置行内富文本单元格
支持流式插入分页符
新增 7 项导出错误信息:ErrUnprotectWorkbook、ErrUnprotectWorkbookPassword、ErrStreamSetPanes、ErrSheetNameBlank、ErrSheetNameInvalid、ErrSheetNameLength和ErrSheetNameSingleQuote，以便开发者可根据不同的错误类型进行采取相应处理
新增 5 项导出数据类型:HeaderFooterOptions、PageLayoutMarginsOptions、PageLayoutOptions、SheetPropsOptions和ViewOptions
支持设置分级显示的明细数据方向
支持读取和设置单元格字体的主题颜色和色调，相关 issue #1369
支持读取带有符合 ISO 8061 标准的时间类型单元格的值
支持设置和读取带有内建颜色索引的字体颜色
工作簿关闭函数将清理由流式写入器生成的磁盘缓存文件
支持添加或删除列时自动调整受影响的列样式
通过AddPicture添加图片时，现已允许插入 SVG 格式图片