Excelize: Go 語言 Excel 文檔基礎庫
Excelize 是 Go 語言編寫的用于操作 Office Excel 文檔類庫,基于 ECMA-376 Office OpenXML 標準。可以使用它來讀取、寫入由 Microsoft Excel? 2007 及以上版本創建的 XLSX 文檔。相比較其他的開源類庫,Excelize 支持寫入原本帶有圖片(表)、透視表和切片器等復雜樣式的文檔,還支持向 Excel 文檔中插入圖片與圖表,并且在保存后不會丟失文檔原有樣式,可以應用于各類報表系統中。
2019年4月23日, 社區正式發布了 2.0.0 版本,該版本包含了很多新功能、錯誤修復和性能優化。下面是有關該版本更新內容的摘要,完整的更改列表可查看change log.
Release Notes
此版本中最顯著的變化包括:
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 v1.4.1 VS v2.0.0
其他
- 文檔內容更新與修正
- 完善單元測試,增加 go1.12 版本下的單元測試