Excelize 發(fā)布 2.6.1 版本，支持工作簿加密

Excelize 是 Go 語言編寫的用于操作 Office Excel 文檔基礎(chǔ)庫，基于 ECMA-376，ISO/IEC 29500 國際標(biāo)準(zhǔn)?？梢允褂盟鼇碜x取、寫入由 Microsoft Excel? 2007 及以上版本創(chuàng)建的電子表格文檔。支持 XLAM / XLSM / XLSX / XLTM / XLTX 等多種文檔格式，高度兼容帶有樣式、圖片(表)、透視表、切片器等復(fù)雜組件的文檔，并提供流式讀寫 API，用于處理包含大規(guī)模數(shù)據(jù)的工作簿?？蓱?yīng)用于各類報表平臺、云計(jì)算、邊緣計(jì)算等系統(tǒng)。入選 2020 Gopher China - Go 領(lǐng)域明星開源項(xiàng)目(GSP)、2018 年開源中國碼云最有價值開源項(xiàng)目 GVP (Gitee Most Valuable Project)，目前已成為 Go 語言最受歡迎的 Excel 文檔基礎(chǔ)庫。

開源代碼

GitHub: github.com/xuri/excelize

Gitee: gitee.com/xurime/excelize

中文文檔: xuri.me/excelize/zh-hans

2022年8月22日，社區(qū)正式發(fā)布了 2.6.1 版本，該版本包含了多項(xiàng)新增功能、錯誤修復(fù)和兼容性提升優(yōu)化。下面是有關(guān)該版本更新內(nèi)容的摘要，完整的更改列表可查看 changelog。

此版本中最顯著的變化包括：

兼容性提示

• 重命名導(dǎo)出類型 TabColor 為 TabColorRGB
• 重命名導(dǎo)出常量 TotalColumns 為 MaxColumns
• 重命名導(dǎo)出變量 ErrMaxFileNameLength 為 ErrMaxFilePathLength
• 重命名導(dǎo)出變量 ErrWorkbookExt 為 ErrWorkbookFileFormat
• 移除了導(dǎo)出變量 ErrEncrypt
• 工作表名稱不再區(qū)分大小寫

新增功能

• 新增 34 項(xiàng)公式函數(shù): 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 函數(shù)支持刪除單元格批注，相關(guān) issue #849
• 通過 AddShape 函數(shù)添加形狀時支持指定宏
• 新增對 1900 和 1904 日期系統(tǒng)的支持，相關(guān) issue #1212
• 新增更新超鏈接支持，相關(guān) issue #1217
• 通過 AddPicture 添加圖片時，現(xiàn)已允許插入 EMF、WMF、EMZ 和 WMZ 格式圖片，相關(guān) issue #1225
• 優(yōu)化打開工作簿失敗時的錯誤提示信息，新增導(dǎo)出變量 ErrWorkbookPassword 定義了打開工作簿時密碼驗(yàn)證失敗的錯誤提示信息，以便開發(fā)者可根據(jù)不同的錯誤類型進(jìn)行采取相應(yīng)處理
• 新增導(dǎo)出常量 MinFontSize、MinColumns 和 MaxCellStyles 以定義最小字號、最小列號和單元格樣式數(shù)量上限
• 公式引擎新增數(shù)組公式支持
• 支持根據(jù)給定的密碼對工作簿進(jìn)行加密保護(hù)，相關(guān) issue #199
• 設(shè)置單元格富文本格式時，支持通過指定 RichTextRun 中的 vertAlign 屬性設(shè)置上標(biāo)和下標(biāo)
• 通過 DeleteDataValidation 函數(shù)刪除數(shù)據(jù)驗(yàn)證時，支持省略第二個引用區(qū)域參數(shù)以刪除工作表中的全部數(shù)據(jù)驗(yàn)證，相關(guān) issue #1254
• 公式計(jì)算引擎支持帶有百分比符號的條件比較表達(dá)式
• 公式計(jì)算引擎支持依賴依賴公式計(jì)算，相關(guān) issue #1262
• 新增文檔打開選項(xiàng) MaxCalcIterations 以支持指定公式迭代計(jì)算的最多迭代次數(shù)
• 新增導(dǎo)出類型 ColorMappingType 以定義顏色轉(zhuǎn)換枚舉類型
• 插入或刪除行列時支持自動調(diào)整表格區(qū)域
• 支持設(shè)置與獲取工作表標(biāo)簽顏色索引、主題和色調(diào)，相關(guān) issue #1283
• 行迭代器新增函數(shù) GetRowOpts 支持讀取行屬性，相關(guān) issue #1296

兼容性提升

• 提升與內(nèi)部包含無效樣式計(jì)數(shù)工作簿的兼容，解決 issue #1211
• 提升與 Google Sheet 的兼容性，解決 issue #1244 和 #1314
• 流式寫入器將不再為值為 nil 的單元格寫入工作表，解決 issue #1299

問題修復(fù)

• 修復(fù)當(dāng)數(shù)據(jù)透視表中值區(qū)間與行/列區(qū)間包含相同字段時，生成的工作簿損壞問題，解決 issue #1203
• 修復(fù)因缺少單元格類型檢查導(dǎo)致的獲取單元格富文本內(nèi)容異常問題，解決 issue #1213
• 修復(fù)讀取單元格值時，因單元格類型推斷錯誤導(dǎo)致的讀取結(jié)果異常問題，解決 issue #1219
• 修復(fù)讀取帶有 0 占位符數(shù)字格式表達(dá)式樣式的單元格時，值為空的問題，解決 #1312 和 #1313
• 修復(fù)部分情況下設(shè)置單元格值時，單元格繼承行列樣式有誤的問題，解決 issue #1163
• 修復(fù)在不包含視圖屬性設(shè)置的工作表中設(shè)置窗格時將出現(xiàn) panic 的問題
• 修復(fù)部分情況下公式引擎多參數(shù)公式計(jì)算結(jié)果有誤的問題
• 修復(fù)因內(nèi)部頁眉頁腳屬性定義順序有誤導(dǎo)致的生成工作簿損壞問題，解決 issue #1257
• 修復(fù)部分情況下單元格賦值失效的問題，解決 issue #1264
• 修復(fù)設(shè)置工作表視圖屬性時可能出現(xiàn)的 panic
• 修復(fù)部分情況下因工作表核心屬性中 dcterms 屬性為空，導(dǎo)致生成的工作簿損壞問題
• 修復(fù)新建工作表后工作簿屬性丟失問題，解決 issue #1298

性能優(yōu)化

• 提高按行賦值和合并單元格的性能，恢復(fù)因修復(fù) issue #1129 時導(dǎo)致的性能下降
• 優(yōu)化了公式計(jì)算引擎的性能
• 降低 AddComment 添加批注時的內(nèi)存開銷并減少耗時，解決 issue #1310

其他

• Go Modules 依賴模塊更新
• 單元測試與文檔更新，修復(fù)單元測試在 go1.19 下的兼容性問題
• 包含簡體中文、英語、法語、俄語、日語、韓語、阿拉伯語、德語和西班牙語的多國語言文檔網(wǎng)站更新

致謝

感謝 Excelize 的所有貢獻(xiàn)者，以下是為此版本提交代碼的貢獻(xiàn)者列表：

• @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