Excelize 是 Go 語言編寫的用於操作 Office Excel 文件類庫,基於 ECMA-376 Office OpenXML 標準。可以使用它來讀取、寫入由 Microsoft Excel™ 2007 及以上版本建立的 XLSX 文件。相比較其他的開源類庫,Excelize 支援寫入原本帶有圖片(表)、透視表和切片器等複雜樣式的文件,還支援向 Excel 文件中插入圖片與圖表,並且在儲存後不會丟失文件原有樣式,可以應用於各類報表系統中。
GitHub: github.com/xuri/excelize
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 列工作表所執行時間和記憶體使用情況:
其他
- 文件內容更新與修正
- 完善單元測試,增加 go1.12 版本下的單元測試
本作品採用《CC 協議》,轉載必須註明作者和本文連結