Excelize 開源基礎發佈 2.8.1 版本，2024 年首個更新

Excelize 是 Go 語言編寫的用於操作電子錶格辦公文檔的開源基礎庫，基於 ISO/IEC 29500、ECMA-376 國際標準。可以使用它來讀取、寫入由 Microsoft Excel、WPS、Apache OpenOffice、LibreOffice 等辦公軟體創建的電子錶格文檔。支持 XLAM / XLSM / XLSX / XLTM / XLTX 等多種文檔格式，高度相容帶有樣式、圖片(表)、透視表、切片器等複雜組件的文檔，並提供流式讀寫支持，用於處理包含大規模數據的工作簿。可應用於各類報表平臺、雲計算、邊緣計算等系統。

開源代碼

GitHub: github.com/xuri/excelize

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

2024年2月26日，社區正式發佈了 2.8.1 版本，該版本包含了多項新增功能、錯誤修複和相容性提升優化。下麵是有關該版本更新內容的摘要，此版本中最顯著的變化包括：

相容性提示

• 升級至該版本需要您使用的 Go 語言為 1.18 或更高版本，以升級依賴庫 golang.org/x/net
• 將數據類型 HeaderFooterOptions 中的欄位 AlignWithMargins 和 ScaleWithDoc 修改為指針類型
• 移除了未使用的導出類型 ShapeColor

新增功能

• 新增函數 SetCellUint 支持設置無符號整型數
• 新增函數 GetPictureCells 支持獲取圖片單元格坐標
• 新增函數 GetConditionalStyle 支持獲取條件格式樣式定義
• 新增函數 GetHeaderFooter 支持獲取工作表頁眉頁腳控制字元設置
• 新增函數 AddSlicer 支持為表格和數據透視表添加切片器
• 新增函數 GetPivotTables 支持獲取數據透視表
• 新增函數 DeletePivotTable 支持刪除數據透視表
• 數據類型 PivotTableOptions 中添加了新的欄位 Name 以支持創建數據透視表時指定自定義數據透視表名稱
• 新增 7 項公式函數：DBCS、SEARCH、SEARCHB、TEXT、TEXTAFTER、TEXTBEFORE 和 xlfn.ANCHORARRAY
• 新增 ChartLineType 枚舉類型，以支持設置圖表區域邊框線型
• 數據類型 Chart 中添加了新的欄位 Border 以支持設置圖表區域邊框類型
• 數據類型 ChartLine 中添加了新的欄位 Type 以支持設置圖表線型
• 新增文檔對象關係部件名稱與命名空間變數 NameSpaceSpreadSheetXR10、ContentTypeSlicer、ContentTypeSlicerCache 和 SourceRelationshipSlicer
• 新增擴展資源標識常量 ExtURIPivotCacheDefinition
• 允許在自定義名稱、表格名稱和數據透視表名稱中使用點字元
• 刪除工作表中的表格時，將保留表格區域全部單元格的值
• 支持讀取帶有分數數字格式的單元格
• 刪除圖片時，如果圖片僅有一處引用，將同時從工作簿內部刪除對應的圖片文件，以減少生成工作簿的體積並消除由此產生的潛在安全風險
• 支持為批註框設置自定義寬度和高度
• 插入或刪除行列時，支持更新條件格式、數據驗證、自定義名稱、圖形對象、單元格公式、易失性函數中的單元格坐標引用
• 新增 6 項新增條件格式類型：“特定文本”、“空值”、“無空值”、“錯誤”、“無錯誤”和“發生日期”
• 公式計算引擎支持計算帶有多重負號的單元格公式
• 複製行時支持複製條件格式與數據驗證
• 設置行高度函數 SetRowHeight 支持通過指定行高度為 -1 移除自定義行高度設置
• 當給定的行高度無效時，函數 SetRowHeight 將返回錯誤提示信息
• 添加圖表函數 AddChart 支持設置圖表中的數據標簽位置
• 添加圖表函數 AddChart 支持設置圖表區域、繪圖區域和數據標記的填充色和透明填充，在 Chart、ChartPlotArea 和 ChartMarker 數據類型中添加了 Fill 選項
• 添加圖表函數 AddChart 支持設置圖表坐標軸文字字體、字型大小和刪除線格式
• 數據類型 ChartSeries 中新增了 DataLabelPosition 欄位，用於指定圖表中各數據系列數據標簽的位置
• 數據類型 Chart 中新增了 BubbleSize 欄位，用於設置氣泡圖和三維氣泡圖的氣泡大小
• 新增導出數據類型 ChartDataLabelPositionType
• 獲取圖片單元格函數 GetPictureCells 和獲取圖片函數 GetPictures 支持讀取由 Kingsoft WPS™ Office 創建的嵌入單元格圖片
• 設置條件格式函數 SetConditionalFormat 支持批量為多個單元格區域設置條件格式
• 重命名工作表時支持更新自定義名稱
• 新增 GetBaseColor 函數，支持讀取首選十六進位顏色代碼
• 公式計算引擎支持讀取日期類型單元格的值
• 單元格值讀取函數支持繼承使用 OpenReader 函數打開文檔時所指定的 Options 選項設置

相容性提升

• 提升了對內部帶有絕對路徑繪圖部件工作簿的相容性
• 提升了對內部帶有浮點型 tabRatio 屬性值工作簿部件的相容性
• 提升了讀取帶有空的自定義數字格式單元格的相容性
• 提升了與不支持預設主題部件命名空間電子錶格預覽程式的相容性
• 提升了單元格批註形狀與 KingSoft WPS™ Office 的相容性
• 保存工作簿時對內部部件進行排序，以確保在不改變工作簿內容時生成的文件具有一致的哈希值

問題修複

• 添加對公式函數 MID 和 MIDB 中 num_chars 參數的檢查，以防止出現負數導致的 panic
• 修複部分情況下，公式函數 LEN、LOWER、PROPER、REPT、UPPER 和 IF 的計算結果為空的問題
• 修複部分情況下，計算公式函數 CHITEST 和 MMULT 時出現 panic 的問題
• 修複 v2.8.0 中引入的問題，通過創建特殊自定義名稱的方式設置列印區域和列印標題時不再返回錯誤
• 修複 v2.8.0 中引入的問題，修複了由於內部樣式部件中索引顏色和 MRU 顏色預設值處理有誤導致的生成工作簿損壞問題
• 修複 v2.8.0 中引入的問題，修複了特定情況下讀取帶有數字格式的單元格結果為空的問題
• 修複 v2.7.1 中引入的問題，修複了氣泡圖和三維氣泡圖中不顯示氣泡的問題
• 修複因內部工作表 ID 處理有誤導致的特定情況下通過 AutoFilter 函數添加自動過濾器時出現的 panic
• 修複部分情況下在工作表中添加表格導致的工作表損壞問題
• 修複部分情況下讀取帶有時間類型數字格式單元格的值有誤的問題
• 支持計算字元型公式單元格的值
• 修複在帶有單元格表格的工作簿中添加表格時，表格 ID 生成有誤的問題
• 修複部分情況下工作簿內容關係部件丟失的問題
• 升級數字格式表達式解析器，以修複對於帶有自定義文本的數字格式表達式格式化結果有誤問題
• 更新了簡體中文和繁體中文語言的預設數字格式列表
• 修複了部分情況下，自定義數字格式索引生成有誤的問題
• 修複通過刪除後再添加表格方式更新表格區域範圍時出現錯誤的問題
• 修複在使用流式讀取函數後，所產生的臨時文件無法被清理的潛在問題
• 修複部分情況下公式計算結果有誤的問題
• 修複併發讀取單元格的值時出現的競態問題
• 修複根據樣式索引獲取樣式定義時，部分樣式定義缺失問題
• 修複部分情況下讀取帶有科學記數法數字格式單元格的值結果有誤的問題
• 修複部分情況下，讀取帶有工作表中不含 r 屬性的行元素導致的 panic 問題
• 修複獲取富文本單元格函數 GetCellRichText 在獲取內聯富文本時返回錯誤的問題
• 修複部分情況下，由於共用字元串表索引計算有誤導致的設置單元格的值結果有誤問題
• 修複函數 GetConditionalFormats 讀取帶有“高於平均值”條件格式規則時 panic 的問題
• 修複了刪除行之後合併單元格有誤的問題
• 修複了 SetConditionalFormat 函數在創建帶有多規則條件格式時，規則優先順序有誤的問題
• 修複了 GetConditionalFormats 函數無法讀取帶有漸變填充格式數據條的問題
• 修複了獲取樣式函數 GetStyle 或獲取條件格式樣式函數 GetConditionalStyle 所返回的小數位數 DecimalPlaces 欄位值有誤問題
• 修複了使用 CalcCellValue 函數時，開啟 RawCellValue 選項失效的問題

性能優化

• 提高了添加與刪除數據透視表和圖片的性能
• 降低了修剪單元格時的記憶體占用

其他

• Go Modules 依賴模塊更新
• 單元測試與文檔更新
• 包含簡體中文、繁體中文、英語、法語、俄語、日語、韓語、阿拉伯語、德語和西班牙語的多國語言文檔網站更新，新增葡萄牙語版本文檔

致謝

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

• fnickels (Francis Nickels III)
• m12r (Matthias Endler)
• Abdelaziz-Ouhammou
• Juneezee (Eng Zer Jun)
• yicixin (壹次心)
• TeeRenJing (rjtee)
• phperic (magicrabbit)
• kjushka (Anton Petrov)
• krstak (Marko Krstic)
• lpxxn (Nick)
• ByteFlyCoding
• yangliyl (Yang Li)
• 15535382838
• TajangSec (Tajang)
• lujin1 (lujin)
• parkoo (Tian)
• ZhangXiao1024 (ZX)
• zcgly
• bramvbilsen (Bram Vanbilsen)
• user65536
• tianaiyouqing (天愛有情)
• cuishuang (cui fliter)
• CooolNv (Xuesong)
• yuegu520
• oneweek20169902 (li)
• 3zmx
• 327674413
• melf-xyzh (MELF曉宇)
• L4nn15ter
• rememberher (Jerry)
• ooooooobh (cherry)
• xxxwang1983
• funa12
• coolbit
• taitaking (zhukewen)
• kewenof
• ivekkairi (Vivek Kairi)
• edwardfward (Ed)

歡迎加入 Excelize 技術交流群: