Excelize 2.7.0 發(fā)布, 2023 年首個更新
Excelize 是 Go 語言編寫的用于操作 Office Excel 文檔基礎(chǔ)庫暇昂，基于 ECMA-376砚著，ISO/IEC 29500 國際標準痒钝。可以使用它來讀取鸯隅、寫入由 Microsoft Excel? 2007 及以上版本創(chuàng)建的電子表格文檔澜建。支持 XLAM / XLSM / XLSX / XLTM / XLTX 等多種文檔格式，高度兼容帶有樣式蝌以、圖片(表)炕舵、透視表、切片器等復(fù)雜組件的文檔跟畅，并提供流式讀寫 API咽筋，用于處理包含大規(guī)模數(shù)據(jù)的工作簿』布可應(yīng)用于各類報表平臺奸攻、云計算、邊緣計算等系統(tǒng)虱痕。入選 2020 Gopher China - Go 領(lǐng)域明星開源項目(GSP)睹耐、2018 年開源中國碼云最有價值開源項目 GVP (Gitee Most Valuable Project)，目前已成為 Go 語言最受歡迎的 Excel 文檔基礎(chǔ)庫部翘。
開源代碼
GitHub: github.com/xuri/excelize
Gitee: gitee.com/xurime/excelize
中文文檔: xuri.me/excelize/zh-hans
2023年1月9日硝训，社區(qū)正式發(fā)布了 2.7.0 版本，該版本包含了多項新增功能新思、錯誤修復(fù)和兼容性提升優(yōu)化捎迫。下面是有關(guān)該版本更新內(nèi)容的摘要，完整的更改列表可查看 changelog表牢。
版本說明
此版本中最顯著的變化包括：
兼容性提示
- 升級至該版本需要您使用的 Go 語言為 1.16 或更高版本，以遷移不再支持的標準庫
ioutil - 當給定工作表名稱中存在無效字符時將返回錯誤贝次，不再自動忽略無效字符
-
GetCellStyle函數(shù)不再返回合并單元格區(qū)域左上角單元格的樣式 - 重命名以下 5 個導(dǎo)出數(shù)據(jù)類型和錯誤常量崔兴，具體更改詳見官方文檔中的更新說明
- 移除了 54 項導(dǎo)出類型，具體更改詳見官方文檔中的更新說明
- 移除了 2 個導(dǎo)出常量：
OrientationPortrait和OrientationLandscape - 修改了以下 21 個函數(shù)的簽名蛔翅，使用結(jié)構(gòu)體引用代替此前以 JSON 格式表示的選項參數(shù)敲茄，具體更改詳見官方文檔中的更新說明
- 引入了 8 項新的函數(shù)代替現(xiàn)有函數(shù)，具體更改詳見官方文檔中的更新說明
- 在
CellType枚舉值中添加CellTypeFormula,CellTypeInlineString,CellTypeSharedString并移除了CellTypeString - 對添加批注
AddComment函數(shù)的簽名進行了更改山析，支持創(chuàng)建富文本批注堰燎，相關(guān) issue #1204 - 當 XML 反序列化異常時將返回錯誤以代替輸出日志，函數(shù)
GetComments,GetDefaultFont和SetDefaultFont增加了 error 類型的錯誤返回值
新增功能
- 新增
GetDataValidations和GetConditionalFormats函數(shù)以支持獲取數(shù)據(jù)驗證設(shè)置和條件格式笋轨，相關(guān) issue #827 - 新增
ProtectWorkbook和UnprotectWorkbook以提供工作簿保護設(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 項導(dǎo)出類型:
AutoFilterListOptions,AutoFilterOptions,Chart,ChartAxis,ChartDimension,ChartLegend,ChartLine,ChartMarker,ChartPlotArea,ChartSeries,ChartTitle,ConditionalFormatOptions,PaneOptions,Panes,GraphicOptions,Shape,ShapeColor,ShapeLine,ShapeParagraph和TableOptions - 新增 2 項公式函數(shù): AGGREGATE 和 SUBTOTAL
-
Save仅讽、Write和WriteTo函數(shù)支持指定保存選項陶缺，相關(guān) issue #744 - 使用
AddChart函數(shù)添加圖表時，支持為折線圖設(shè)置是否使用平滑折線洁灵，相關(guān) issue #1290 - 使用
AddChart函數(shù)添加圖表時饱岸，支持設(shè)置自定義折線圖線條顏色，相關(guān) issue #1345 - 使用
AddChart函數(shù)添加圖表時徽千，支持設(shè)置自定義坐標軸字體樣式苫费，相關(guān) issue #320 - 添加圖表函數(shù)
AddChart支持創(chuàng)建三維折線圖 - 以下函數(shù)新增并發(fā)安全支持：
SetColWidth、GetColWidth双抽、SetColVisible百框、GetColVisible、SetColStyle和GetColStyle - 設(shè)置樣式時荠诬，當給定的樣式 ID 不存在時將返回錯誤琅翻，相關(guān) issue #1323
- 流式按行賦值時，若行號未遞增將返回錯誤柑贞，以避免生成的工作簿損壞方椎，相關(guān) issue #1139
- 按行流式寫入工作表時，支持通過指定
RowOpts為單元格設(shè)置樣式钧嘶，相關(guān) issue #1354 - 支持流式設(shè)置窗格棠众，相關(guān) issue #1047
- 支持流式設(shè)置行內(nèi)富文本單元格
- 支持流式插入分頁符
- 新增 7 項導(dǎo)出錯誤信息:
ErrUnprotectWorkbook、ErrUnprotectWorkbookPassword有决、ErrStreamSetPanes闸拿、ErrSheetNameBlank、ErrSheetNameInvalid书幕、ErrSheetNameLength和ErrSheetNameSingleQuote新荤，以便開發(fā)者可根據(jù)不同的錯誤類型進行采取相應(yīng)處理 - 新增 5 項導(dǎo)出數(shù)據(jù)類型:
HeaderFooterOptions、PageLayoutMarginsOptions台汇、PageLayoutOptions苛骨、SheetPropsOptions和ViewOptions - 支持設(shè)置分級顯示的明細數(shù)據(jù)方向
- 支持讀取和設(shè)置單元格字體的主題顏色和色調(diào)，相關(guān) issue #1369
- 支持讀取帶有符合 ISO 8061 標準的時間類型單元格的值
- 支持設(shè)置和讀取帶有內(nèi)建顏色索引的字體顏色
- 工作簿關(guān)閉函數(shù)將清理由流式寫入器生成的磁盤緩存文件
- 支持添加或刪除列時自動調(diào)整受影響的列樣式
- 通過
AddPicture添加圖片時苟呐，現(xiàn)已允許插入 SVG 格式圖片
兼容性提升
- 流式寫入單元格時將以行內(nèi)字符類型存儲字符型單元格的值痒芝，相關(guān) issue #1377
- 保存工作簿時將跳過工作表中的不帶有樣式和屬性的空白行，以減少生成文檔的體積牵素，相關(guān) issue #1383
問題修復(fù)
- 修復(fù)部分情況下讀取帶有內(nèi)建數(shù)字格式樣式的浮點數(shù)精度有誤問題严衬，解決 issue #1328，#1368 和 #1373
- 修復(fù)部分情況下讀取帶有 AM/PM 數(shù)字格式樣式的單元格有誤問題笆呆，解決 issue #1338
- 修復(fù)部分情況下刪除批注時由于數(shù)組下標越界導(dǎo)致的 panic请琳，解決 issue #1343
- 修復(fù)部分情況下讀取單元格的值時出現(xiàn) panic 的問題粱挡，解決 issue #1384 和 #1415
- 修復(fù)部分情況下誤將文本解析為浮點型數(shù)值的問題，解決 issue #1360
- 修復(fù)使用空字符創(chuàng)建工作表后生成的工作簿損壞問題单起，解決 issue #1361
- 修復(fù)向工作表添加圖片后抱怔，獲取該圖片內(nèi)容為空的問題
- 修復(fù)部分情況下插入行列后生成的工作簿損壞問題
- 刪除單元格公式時將刪除公式計算鏈中的共享單元格引用，以修復(fù)部分情況下生成的文檔損壞問題
- 修復(fù)部分情況下未對工作表名稱特殊字符及長度做正確處理的問題嘀倒，解決 issue #1328
- 修復(fù)部分情況下公式函數(shù)
OR計算結(jié)果有誤的問題 - 修復(fù)在帶有單一單元格區(qū)域引用的工作表中插入行列時屈留，將收到異常的問題
- 修復(fù)獲取帶有單一單元格區(qū)域引用合并單元格區(qū)域時，收到異常的問題
- 修復(fù)部分情況下讀取富文本單元格的值不完整問題
- 修復(fù)流式寫入時未轉(zhuǎn)義 XML 字符導(dǎo)致的文檔損壞問題测蘑，解決 issue #1391
- 修復(fù)公式計算函數(shù) ADDRESS 在工作表名稱為空時計算結(jié)果有誤的問題灌危，解決 issue #1396
- 修復(fù)部分情況下添加圖片結(jié)果有誤的問題，解決 issue #1404
性能優(yōu)化
- 提高流式合并單元格性能碳胳，相較于上一版本勇蝙，耗時最高降低約 90%，內(nèi)存使用最高減少約 86%
- 優(yōu)化按行流式寫入工作表
SetRow函數(shù)的性能挨约，相較于上一版本味混，耗時最高降低約 19%
其他
- Go Modules 依賴模塊更新
- 單元測試與文檔更新
- 優(yōu)化內(nèi)部變量與函數(shù)命名
- 包含簡體中文、英語诫惭、法語翁锡、俄語、日語夕土、韓語馆衔、阿拉伯語、德語和西班牙語的多國語言文檔網(wǎng)站更新
致謝
感謝 Excelize 的所有貢獻者怨绣，以下是為此版本提交代碼的貢獻者列表：
- 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)
