19.6. v2.0.0
Excelize v2.0.0
- 发布日期: 2019年5月2日
- GitHub Release: github.com/xuri/excelize/releases/...
版本说明
此版本中最显著的变化包括:
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 开发者指南
关于 LearnKu