Excelize 是 Go 語言編寫的用於操作 Office Excel 檔案基礎庫,基於 ECMA-376,ISO/IEC 29500 國際標準。可以使用它來讀取、寫入由 Microsoft Excel™ 2007 及以上版本創建的電子錶格檔案。支持 XLAM / XLSM / XLSX / XLTM / XLTX 等多種檔案格式,高度兼容帶有樣式、圖片(表)、樞紐分析表、切片器等複雜組件的檔案,並提供流式讀寫 API,用於處理包含大規模數據的活頁簿。可應用於各類報表平台、雲計算、邊緣計算等系統。入選 2020 Gopher China - Go 領域明星開源項目 (GSP)、 2018 開源中國碼雲 Gitee 最有價值開源項目 GVP,目前已成為 Go 語言最受歡迎的 Excel 檔案基礎庫。
2022年8月22日,社區正式釋出了 2.6.1 版本,該版本包含了多項新增功能、錯誤修復和兼容性提升優化。下面是有關該版本更新內容的摘要,完整的更改列表可查看 changelog。
此版本中最顯著的變化包括:
兼容性提示
- 重命名導出類型
TabColor
為 TabColorRGB
- 重命名導出常數
TotalColumns
為 MaxColumns
- 重命名導出變數
ErrMaxFileNameLength
為 ErrMaxFilePathLength
- 重命名導出變數
ErrWorkbookExt
為 ErrWorkbookFileFormat
- 移除了導出變數
ErrEncrypt
- 工作表名稱不再區分大小寫
新增功能
- 新增 34 項公式函數: CONVERT, COVARIANCE.S, DAVERAGE, DAYS360, DCOUNT, DCOUNTA, DGET, DMAX, DMIN, DPRODUCT, DSTDEV, DSTDEVP, DSUM, DVAR, DVARP, EDATE, EOMONTH, EUROCONVERT, GROWTH, HYPERLINK, MINVERSE, MMULT, NETWORKDAYS, NETWORKDAYS.INTL, PEARSON, RSQ, SKEW.P, SLOPE, STDEVPA, STEYX, TREND, WEEKNUM, WORKDAY, WORKDAY.INTL
- 新增
DeleteComment
函數支持刪除存儲格註解,相關 issue #849
- 通過
AddShape
函數添加形狀時支持指定宏
- 新增對 1900 和 1904 日期系統的支持,相關 issue #1212
- 新增更新超鏈接支持,相關 issue #1217
- 通過
AddPicture
添加圖片時,現已允許插入 EMF、WMF、EMZ 和 WMZ 格式圖片,相關 issue #1225
- 優化打開活頁簿失敗時的錯誤提示信息,新增導出變數
ErrWorkbookPassword
定義了打開活頁簿時密碼驗證失敗的錯誤提示信息,以便開發者可根據不同的錯誤類型進行採取相應處理
- 新增導出常量
MinFontSize
、MinColumns
和 MaxCellStyles
以定義最小字號和最小欄號
- 公式引擎新增數組公式支持
- 支持根據給定的密碼對活頁簿進行加密保護,相關 issue #199
- 設定儲存格富文本格式時,支持通過指定
RichTextRun
中的 vertAlign` 屬性設定上標和下標
- 通過
DeleteDataValidation
函數刪除數據驗證時,支持省略第二個引用區域參數以刪除工作表中的全部數據驗證,相關 issue #1254
- 公式計算引擎支持帶有百分比符號的條件比較表達式
- 公式計算引擎支持依賴依賴公式計算,相關 issue #1262
- 新增文檔打開選項
MaxCalcIterations
以支持指定公式迭代計算的最多迭代次數
- 新增導出類型
ColorMappingType
以定義顏色轉換枚舉類型
- 插入或刪除列列時支持自動調整表格區域
- 支持設定與獲取工作表標籤顏色索引、主題和色調,相關 #1283
- 列迭代器新增函數
GetRowOpts
支持讀取列屬性,相關 issue #1296
兼容性提升
- 提升與內部包含無效樣式計數活頁簿的兼容,解決 issue #1211
- 提升與 Google Sheet 的兼容性,解決 issue #1244 和 #1314
- 流式寫入器將不再為值為 nil 的存儲格寫入工作表,解決 issue #1299
問題修復
- 修復當樞紐分析表中值區間與列/欄區間包含相同欄位時,生成的活頁簿損壞問題,解決 issue #1203
- 修復因缺少儲存格類型檢查導致的獲取儲存格富文本內容異常問題,解決 issue #1213
- 修復讀取儲存格值時,因儲存格類型推斷錯誤導致的讀取結果異常問題,解決 issue #1219
- 修復讀取帶有 0 佔位符數字格式表達式樣式的存儲格時,值為空的問題,解決 #1312 和 #1313
- 修復部分情況下設定儲存格值時,儲存格繼承列/欄樣式有誤的問題,解決 issue #1163
- 修復在不包含檢視屬性設定的工作表中設定窗格時將出現 panic 的問題
- 修復部分情況下公式引擎多參數公式計算結果有誤的問題
- 修復因內部頁眉頁腳屬性定義順序有誤導致的生成活頁簿損壞問題,解決 issue #1257
- 修復部分情況下存儲格賦值失效的問題,解決 issue #1264
- 修復設定工作表視圖屬性時可能出現的 panic
- 修復部分情況下因工作表核心屬性中 dcterms 屬性為空,導致生成的活页簿損壞問題
- 修復新建工作表後活頁簿屬性丟失問題,解決 issue #1298
性能優化
- 提高按行賦值和合併儲存格的性能,恢復因修復 issue #1129 時導致的性能下降
- 優化了公式計算引擎的性能
- 降低
AddComment
添加註解時的內存開銷並減少耗時,解決 issue #1310
其他
- Go Modules 依賴模塊更新
- 單元測試與文檔更新,修復單元測試在 go1.19 下的兼容性問題
- 包含簡體中文、英語、法語、俄語、日語、韓語、阿拉伯語、德語和西班牙語的多國語言文檔網站更新
致謝
感謝 Excelize 的所有貢獻者,以下是為此版本提交代碼的貢獻者列表:
- @JDavidVR (David)
- @sceneq
- @Juneezee (Eng Zer Jun)
- @MichealJl (jialei)
- @ww1516123
- @z-hua (z.hua)
- @xdlrt (yeshu)
- @eaglexiang (Eagle Xiang)
- @MJacred
- @ReganYue (Regan Yue)
- @thomascharbonnel (Thomas Charbonnel)
- @ee0703 (EE)
- @NaturalGao (NaturalGao)
- @Sangua633