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 技術交流羣:
