Excelize 2.7.0 發(fā)布, 2023 年首個(gè)更新

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

開(kāi)源代碼

GitHub: github.com/xuri/excelize

Gitee: gitee.com/xurime/excelize

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

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

版本說(shuō)明

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

兼容性提示

• 升級(jí)至該版本需要您使用的 Go 語(yǔ)言為 1.16 或更高版本，以遷移不再支持的標(biāo)準(zhǔn)庫(kù) ioutil
• 當(dāng)給定工作表名稱(chēng)中存在無(wú)效字符時(shí)將返回錯(cuò)誤，不再自動(dòng)忽略無(wú)效字符
• GetCellStyle 函數(shù)不再返回合并單元格區(qū)域左上角單元格的樣式
• 重命名以下 5 個(gè)導(dǎo)出數(shù)據(jù)類(lèi)型和錯(cuò)誤常量，具體更改詳見(jiàn)官方文檔中的更新說(shuō)明
• 移除了 54 項(xiàng)導(dǎo)出類(lèi)型，具體更改詳見(jiàn)官方文檔中的更新說(shuō)明
• 移除了 2 個(gè)導(dǎo)出常量：OrientationPortrait 和 OrientationLandscape
• 修改了以下 21 個(gè)函數(shù)的簽名，使用結(jié)構(gòu)體引用代替此前以 JSON 格式表示的選項(xiàng)參數(shù)，具體更改詳見(jiàn)官方文檔中的更新說(shuō)明
• 引入了 8 項(xiàng)新的函數(shù)代替現(xiàn)有函數(shù)，具體更改詳見(jiàn)官方文檔中的更新說(shuō)明
• 在 CellType 枚舉值中添加 CellTypeFormula, CellTypeInlineString, CellTypeSharedString 并移除了 CellTypeString
• 對(duì)添加批注 AddComment 函數(shù)的簽名進(jìn)行了更改，支持創(chuàng)建富文本批注，相關(guān) issue #1204
• 當(dāng) XML 反序列化異常時(shí)將返回錯(cuò)誤以代替輸出日志，函數(shù) GetComments, GetDefaultFont 和 SetDefaultFont 增加了 error 類(lèi)型的錯(cuò)誤返回值

新增功能

• 新增 GetDataValidations 和 GetConditionalFormats 函數(shù)以支持獲取數(shù)據(jù)驗(yàn)證設(shè)置和條件格式，相關(guān) issue #827
• 新增 ProtectWorkbook 和 UnprotectWorkbook 以提供工作簿保護(hù)設(shè)置支持
• 新增 SetSheetCol 函數(shù)以支持按列設(shè)置單元格的值，相關(guān) issue #1247
• 新增 GetColStyle 函數(shù)以支持設(shè)置列樣式，相關(guān) issue #1293
• 新增 SetSheetBackgroundFromBytes 函數(shù)以支持根據(jù)給定的圖片數(shù)據(jù)設(shè)置工作表背景圖片，相關(guān) issue #1405
• 新增導(dǎo)出變量 IndexedColorMapping 以支持內(nèi)建索引顏色轉(zhuǎn)換
• 新增 20 項(xiàng)導(dǎo)出類(lèi)型: AutoFilterListOptions, AutoFilterOptions, Chart, ChartAxis, ChartDimension, ChartLegend, ChartLine, ChartMarker, ChartPlotArea, ChartSeries, ChartTitle, ConditionalFormatOptions, PaneOptions, Panes, GraphicOptions, Shape, ShapeColor, ShapeLine, ShapeParagraph 和 TableOptions
• 新增 2 項(xiàng)公式函數(shù): AGGREGATE 和 SUBTOTAL
• Save、Write 和 WriteTo 函數(shù)支持指定保存選項(xiàng)，相關(guān) issue #744
• 使用 AddChart 函數(shù)添加圖表時(shí)，支持為折線圖設(shè)置是否使用平滑折線，相關(guān) issue #1290
• 使用 AddChart 函數(shù)添加圖表時(shí)，支持設(shè)置自定義折線圖線條顏色，相關(guān) issue #1345
• 使用 AddChart 函數(shù)添加圖表時(shí)，支持設(shè)置自定義坐標(biāo)軸字體樣式，相關(guān) issue #320
• 添加圖表函數(shù) AddChart 支持創(chuàng)建三維折線圖
• 以下函數(shù)新增并發(fā)安全支持：SetColWidth、GetColWidth、SetColVisible、GetColVisible、SetColStyle 和 GetColStyle
• 設(shè)置樣式時(shí)，當(dāng)給定的樣式 ID 不存在時(shí)將返回錯(cuò)誤，相關(guān) issue #1323
• 流式按行賦值時(shí)，若行號(hào)未遞增將返回錯(cuò)誤，以避免生成的工作簿損壞，相關(guān) issue #1139
• 按行流式寫(xiě)入工作表時(shí)，支持通過(guò)指定 RowOpts 為單元格設(shè)置樣式，相關(guān) issue #1354
• 支持流式設(shè)置窗格，相關(guān) issue #1047
• 支持流式設(shè)置行內(nèi)富文本單元格
• 支持流式插入分頁(yè)符
• 新增 7 項(xiàng)導(dǎo)出錯(cuò)誤信息: ErrUnprotectWorkbook、ErrUnprotectWorkbookPassword、ErrStreamSetPanes、ErrSheetNameBlank、ErrSheetNameInvalid、ErrSheetNameLength 和 ErrSheetNameSingleQuote，以便開(kāi)發(fā)者可根據(jù)不同的錯(cuò)誤類(lèi)型進(jìn)行采取相應(yīng)處理
• 新增 5 項(xiàng)導(dǎo)出數(shù)據(jù)類(lèi)型: HeaderFooterOptions、PageLayoutMarginsOptions、PageLayoutOptions、SheetPropsOptions 和 ViewOptions
• 支持設(shè)置分級(jí)顯示的明細(xì)數(shù)據(jù)方向
• 支持讀取和設(shè)置單元格字體的主題顏色和色調(diào)，相關(guān) issue #1369
• 支持讀取帶有符合 ISO 8061 標(biāo)準(zhǔn)的時(shí)間類(lèi)型單元格的值
• 支持設(shè)置和讀取帶有內(nèi)建顏色索引的字體顏色
• 工作簿關(guān)閉函數(shù)將清理由流式寫(xiě)入器生成的磁盤(pán)緩存文件
• 支持添加或刪除列時(shí)自動(dòng)調(diào)整受影響的列樣式
• 通過(guò) AddPicture 添加圖片時(shí)，現(xiàn)已允許插入 SVG 格式圖片

兼容性提升

• 流式寫(xiě)入單元格時(shí)將以行內(nèi)字符類(lèi)型存儲(chǔ)字符型單元格的值，相關(guān) issue #1377
• 保存工作簿時(shí)將跳過(guò)工作表中的不帶有樣式和屬性的空白行，以減少生成文檔的體積，相關(guān) issue #1383

問(wèn)題修復(fù)

• 修復(fù)部分情況下讀取帶有內(nèi)建數(shù)字格式樣式的浮點(diǎn)數(shù)精度有誤問(wèn)題，解決 issue #1328，#1368 和 #1373
• 修復(fù)部分情況下讀取帶有 AM/PM 數(shù)字格式樣式的單元格有誤問(wèn)題，解決 issue #1338
• 修復(fù)部分情況下刪除批注時(shí)由于數(shù)組下標(biāo)越界導(dǎo)致的 panic，解決 issue #1343
• 修復(fù)部分情況下讀取單元格的值時(shí)出現(xiàn) panic 的問(wèn)題，解決 issue #1384 和 #1415
• 修復(fù)部分情況下誤將文本解析為浮點(diǎn)型數(shù)值的問(wèn)題，解決 issue #1360
• 修復(fù)使用空字符創(chuàng)建工作表后生成的工作簿損壞問(wèn)題，解決 issue #1361
• 修復(fù)向工作表添加圖片后，獲取該圖片內(nèi)容為空的問(wèn)題
• 修復(fù)部分情況下插入行列后生成的工作簿損壞問(wèn)題
• 刪除單元格公式時(shí)將刪除公式計(jì)算鏈中的共享單元格引用，以修復(fù)部分情況下生成的文檔損壞問(wèn)題
• 修復(fù)部分情況下未對(duì)工作表名稱(chēng)特殊字符及長(zhǎng)度做正確處理的問(wèn)題，解決 issue #1328
• 修復(fù)部分情況下公式函數(shù) OR 計(jì)算結(jié)果有誤的問(wèn)題
• 修復(fù)在帶有單一單元格區(qū)域引用的工作表中插入行列時(shí)，將收到異常的問(wèn)題
• 修復(fù)獲取帶有單一單元格區(qū)域引用合并單元格區(qū)域時(shí)，收到異常的問(wèn)題
• 修復(fù)部分情況下讀取富文本單元格的值不完整問(wèn)題
• 修復(fù)流式寫(xiě)入時(shí)未轉(zhuǎn)義 XML 字符導(dǎo)致的文檔損壞問(wèn)題，解決 issue #1391
• 修復(fù)公式計(jì)算函數(shù) ADDRESS 在工作表名稱(chēng)為空時(shí)計(jì)算結(jié)果有誤的問(wèn)題，解決 issue #1396
• 修復(fù)部分情況下添加圖片結(jié)果有誤的問(wèn)題，解決 issue #1404

性能優(yōu)化

• 提高流式合并單元格性能，相較于上一版本，耗時(shí)最高降低約 90%，內(nèi)存使用最高減少約 86%
• 優(yōu)化按行流式寫(xiě)入工作表 SetRow 函數(shù)的性能，相較于上一版本，耗時(shí)最高降低約 19%

其他

• Go Modules 依賴模塊更新
• 單元測(cè)試與文檔更新
• 優(yōu)化內(nèi)部變量與函數(shù)命名
• 包含簡(jiǎn)體中文、英語(yǔ)、法語(yǔ)、俄語(yǔ)、日語(yǔ)、韓語(yǔ)、阿拉伯語(yǔ)、德語(yǔ)和西班牙語(yǔ)的多國(guó)語(yǔ)言文檔網(wǎng)站更新

致謝

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

• cdenicola (Cooper de Nicola)
• chenliu1993
• davidborry
• patsak (Kostya Privezentsev)
• dafengge0913
• Beeb0p (Artem Tarasenko)
• invzhi
• zhangzitao (Zitao)
• jtwatson (Joseph Watson)
• carbin-gun (charles.deng)
• harrison3000 (Harrison)
• strivek (GaoFei)
• gonghaibinx
• martinmr (Martin Martinez Rivera)
• zclark (Zach Clark)
• March0715 (March)
• renxiaotu
• devloppper
• jianxinhou
• nesstord
• Bayzet (Bayzet Tlyupov)
• guoweikuang (郭偉匡)
• qinyuguang (Gin)
• liron-l (Liron Levin)