Excelize文档类库 v2.8.1

Excelize 是 Go 语言编写的用于操作 Office Excel 文档基础库，基于 ECMA-376，ISO/IEC 29500 国际标准。可以使用它来读取、写入由 Microsoft Excel? 2007 及以上版本创建的电子表格文档。支持 XLSX / XLSM / XLTM 等多种文档格式，高度兼容带有样式、图片(表)、透视表、切片器等复杂组件的文档，并提供流式读写 API，用于处理包含大规模数据的工作簿。可应用于各类报表平台、云计算、边缘计算等系统。使用本类库要求使用的 Go 语言为 1.10 或更高版本。

安装：

go get github.com/360EntSecGroup-Skylar/excelize

如果您使用 Go Modules 管理软件包，请使用下面的命令来安装最新版本。

go get github.com/360EntSecGroup-Skylar/excelize/v2

功能：

1、创建 Excel 文档

2、读取 Excel 文档

3、在 Excel 文档中创建图表

使用 Excelize 生成图表十分简单，仅需几行代码。您可以根据工作表中的已有数据构建图表，或向工作表中添加数据并创建图表。

4、向 Excel 文档中插入图片

更新日志：

v2.8.1

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

兼容性提示

移除了 ChartLine 数据类型中的 Color 字段

使用 RichTextRun 数据类型代替 ShapeParagraph

使用 Fill 代替 Shape 数据类型中的 Color 字段

移除了已导出的数据类型 AutoFilterListOptions

将数据类型 TableOptions 重命名为 Table

添加图表函数 AddChart 改为使用 ChartType 类型枚举值指定图表类型

修改了以下 7 个函数的签名

将 func (f *File) AutoFilter(sheet, rangeRef string, opts *AutoFilterOptions) error 修改为 func (f *File) AutoFilter(sheet, rangeRef string, opts []AutoFilterOptions) error

将 func (f *File) AddPictureFromBytes(sheet, cell, name, extension string, file []byte, opts *GraphicOptions) error 修改为 func (f *File) AddPictureFromBytes(sheet, cell string, pic *Picture) error

将 func (f *File) GetPicture(sheet, cell string) (string, []byte, error) 修改为 func (f *File) GetPictures(sheet, cell string) ([]Picture, error)

将 func (f *File) AddVBAProject(bin string) error 修改为 func (f *File) AddVBAProject(file []byte) error

将 func (f *File) GetComments() (map[string][]Comment, error) 修改为 func (f *File) GetComments(sheet string) ([]Comment, error)

将 func (f *File) AddTable(sheet, rangeRef string, opts *TableOptions) error 修改为 func (f *File) AddTable(sheet string, table *Table) error

将 func (sw *StreamWriter) AddTable(rangeRef string, opts *TableOptions) error 修改为 func (sw *StreamWriter) AddTable(table *Table) error

新增功能

新增函数 SetSheetDimension 与 GetSheetDimension 以支持设置与获取工作表已用区域

创建样式函数 NewStyle 现已支持 17 种渐变填充样式

增加创建样式数量上限至 65430

通过 AddPicture 添加图片时，现已允许插入 BMP 格式图片

函数 GetPictures 支持读取被添加至同一单元格中的多张图片

设置条件格式函数 SetConditionalFormat 支持设置带有“如果为真则停止”和“图标集”条件的条件格式规则

设置条件格式函数 SetConditionalFormat 支持设置在条件格式中使用带有纯色填充样式的数据条，并支持指定数据条的颜色

添加图表函数 AddChart 支持设置图表中各个数据系列使用自定义填充颜色

添加图表函数 AddChart 支持设置气泡图图表中各个系列气泡的大小

添加图表函数 AddChart 支持设置子母饼图和复合条饼图中第二绘图区域的数据系列

添加图表函数 AddChart 支持为图表中数据标签设置自定义数字格式

创建表格函数 AddTable 支持在创建表格时指定是否包含标题行

创建表格函数 AddTable 创建表格时增加对表格名称的校验，并导出了错误常量 ErrTableNameLength

函数 AutoFilter 支持为筛选范围内的多个列设置筛选条件

计算单元格的值函数 CalcCellValue 现已支持指定是否为公式计算结果应用数字格式

计算单元格的值函数 CalcCellValue 对于以下公式函数加入了双字节字符的支持：LEFT, LEN, LENB, MID, MIDB, RIGHT 和 RIGHTB

计算单元格的值函数 CalcCellValue 函数对于存在错误的公式将在计算结果中返回公式错误代码，并将详细错误信息在 error 数据类型的返回值中返回

对输入图片文件的扩展名调整为大小写不敏感

使用流式写入器流式按行赋值时，对于值为 nil 的单元格将会跳过生成该单元格

获取超链接 GetCellHyperLink 函数支持读取合并单元格中的超链接

添加了新的导出类型 ChartType 以表示图表类型枚举

兼容性提升

兼容带有函数组的工作簿

兼容带有严格模式 XML 命名空间地址的工作簿主题，相关 issue #1447

提高了与文档内部不含工作簿关系部件工作簿的兼容性，以修复打开此类工作簿可能出现的 panic

问题修复

修复了特定情况下读取日期时间类型单元格的值存在精度误差的问题

修复了特定情况下当修改原本存储了日期时间类型的单元格为文本类型值，修改后单元格数据类型有误的问题

修复了部分情况下公式计算结果为空的问题

修复了设置数据条类型条件格式时，指定自定义最大/最小值无效的问题

修复了打开行高或列宽为 0 的工作表，保存后行高列宽设置失效的问题

提高了读取带有空白字符共享字符串表索引值的兼容性

性能优化

提高了应用带有自定义月份数字格式的速度

大幅提高了对于带有合并单元格工作表的处理速度

其他

Go Excelize 提供了支持 WebAssembly / Javascript 环境的 excelize-wasm NPM 包

Go Modules 依赖模块更新

单元测试与文档更新

优化内部变量与函数命名

包含简体中文、英语、法语、俄语、日语、韩语、阿拉伯语、德语和西班牙语的多国语言文档网站更新