Excelize v2.0.0

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

版本说明

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

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 列工作表所执行时间和内存使用情况:

Excelize Go 语言 Excel 文档类库 v1.4.1 和 v2.0.0 性能对比

其他

  • 文档内容更新与修正
  • 完善单元测试,增加 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)