Excelize 發佈 2.6.1 版本，支持工作簿加密

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

歡迎加入 Slack 頻道、Telegram 群組 或技術交流群 DingTalk Group ID: 30047129 QQ Group ID: 207895940