Excelize 是 Go 語言編寫的用於操作 Office Excel 文件基礎庫,基於 ECMA-376,ISO/IEC 29500 國際標準。可以使用它來讀取、寫入由 Microsoft Excel™ 2007 及以上版本建立的電子表格文件。支援 XLAM / XLSM / XLSX / XLTM / XLTX 等多種文件格式,高度相容帶有樣式、圖片(表)、透視表、切片器等複雜元件的文件,並提供流式讀寫 API,用於處理包含大規模資料的工作簿。可應用於各類報表平臺、雲端計算、邊緣計算等系統。入選 2020 Gopher China - Go 領域明星開源專案(GSP)、2018 年開源中國碼雲最有價值開源專案 GVP (Gitee Most Valuable Project),目前已成為 Go 語言最受歡迎的 Excel 文件基礎庫。
開原始碼
GitHub: github.com/xuri/excelize
Gitee: gitee.com/xurime/excelize
中文文件: xuri.me/excelize/zh-hans
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
以定義顏色轉換列舉型別 - 插入或刪除行列時支援自動調整表格區域
- 支援設定與獲取工作表標籤顏色索引、主題和色調,相關 issue #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
本作品採用《CC 協議》,轉載必須註明作者和本文連結