Excelize v2.0.0
- 版本说明

Excelize v2.0.0

《Excelize 权威指南》图书出版，网上购买方式：人民邮电出版社 |异步社区 |天猫 |京东 |当当 |微店 |抖音 |拼多多

发布日期: 2019年5月2日
GitHub Release: https://github.com/xuri/excelize/releases/tag/v2.0.0

版本说明

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

API 更改

下表列出了 v2.0.0 相比较于 v1.4.1 版本，API 的更改情况：

函数名	增加 `error` 返回值	行号计算方法变更^*	删除	新增
ToAlphaString	×	×	√	×
TitleToNumber	×	×	√	×
SplitCellName	×	×	×	√
JoinCellName	×	×	×	√
ColumnNameToNumber	×	×	×	√
ColumnNumberToName	×	×	×	√
CellNameToCoordinates	×	×	×	√
CoordinatesToCellName	×	×	×	√
DuplicateRowTo	×	×	×	√
SetCellFloat	×	×	×	√
SetCellStyle	√	×	×	×
InsertCol	√	×	×	×
RemoveCol	√	×	×	×
RemoveRow	√	√	×	×
InsertRow	√	√	×	×
DuplicateRow	√	×	×	×
SetRowHeight	√	×	×	×
GetRowHeight	√	×	×	×
GetCellValue	√	×	×	×
GetCellFormula	√	×	×	×
GetCellHyperLink	√	×	×	×
SetCellHyperLink	√	×	×	×
SetCellInt	√	×	×	×
SetCellBool	√	×	×	×
SetCellStr	√	×	×	×
SetCellDefault	√	×	×	×
GetCellStyle	√	×	×	×
SetCellValue	√	×	×	×
MergeCell	√	×	×	×
SetSheetRow	√	×	×	×
SetRowVisible	√	√	×	×
GetRowVisible	√	√	×	×
SetRowOutlineLevel	√	√	×	×
GetRowOutlineLevel	√	√	×	×
GetRows	√	×	×	×
Columns	√	×	×	×
SearchSheet	√	×	×	×
GetPicture	√	×	×	×
AutoFilter	√	×	×	×
GetColVisible	√	×	×	×
SetColVisible	√	×	×	×
GetColOutlineLevel	√	×	×	×
SetColOutlineLevel	√	×	×	×
SetColWidth	√	×	×	×
GetColWidth	√	×	×	×
GetMergeCells	√	×	×	×
ProtectSheet	√	×	×	×
UnprotectSheet	√	×	×	×
UpdateLinkedValue	√	×	×	×
SetSheetVisible	√	×	×	×
adjustHelper	√	×	×	×
adjustMergeCells	√	×	×	×
adjustAutoFilter	√	×	×	×
prepareCell	√	×	×	×
setDefaultTimeStyle	√	×	×	×
timeToExcelTime	√	×	×	×
addDrawingChart	√	×	×	×
addDrawingVML	√	×	×	×
addDrawingPicture	√	×	×	×
getTotalRowsCols	√	×	×	×
checkRow	√	×	×	×
addDrawingShape	√	×	×	×
addTable	√	×	×	×
workSheetReader	√	×	×	×
copySheet	√	×	×	×

* 从版本 v2.0.0 开始，所有行操作方法都使用从 1 开始的 Excel 行编号，早期版本中某些方法中的基于 0 的行编号将不再使用，参考相关 issue #349。

新增功能

新增 DuplicateRowTo 方法, 支持根据给定的工作表名称和行号，在指定行后复制该行
工作表页面布局设置函数 SetPageLayout 新增对页面布局方向设置的支持，解决了相关 issue #318
工作表页面布局设置函数 SetPageLayout 新增对页面纸张大小设置的支持

问题修复

修复部分情况下，在样式格式中未指定单元格颜色填充时，创建了空白填充的问题
修复当工作表数据验证公式超过 225 个字符时，文件打开失败的问题，解决了相关 issue #339
修复部分情况下，删除带有公式的单元格会导致文件损坏的问题，解决了相关 issue #346
修复通过获取批注函数 GetComment，从包含多个工作表的工作簿获取批注时，返回了错误的工作表名称的问题，解决了相关 issue #345
修复获取工作表全部单元格函数 GetRows 返回多余的列的问题
修复部分情况下删除包含公式的工作表引起文档损坏的问题

性能提升

单元格赋值系列函数、添加批注、图片、图表、超链接和形状函数的性能，均获得了大幅提升
新增重复图片检查，将用添加引用代替添加重复图片，解决了相关 issue #359

下图是 v1.4.1 和 v2.0.0 版本下创建 12800 行 50 列工作表所执行时间和内存使用情况：

其他

文档内容更新与修正
完善单元测试，增加 go1.12 版本下的单元测试

致谢

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

@zhangleijlu
@mmitton
@albenik (Veniamin Albaev)
@kkxkkxkkgh (RetainLiao)
@rentiansheng (Reage)
@dolmen (Olivier Mengué)
@BluesJhao
@Kimxu (Kimxu)
@caozhiyi (no_one)
@mlh758 (Michael Harris)
@yoshhiide (Yoshihide NABEYAMA)
@aplulu (Aplulu)

v2.0.0 (2019-05-02)