<p align="center"><img src="https://xuri.me/excelize/images/excelize.svg" width="440" alt="github.com/360EntSecGroup-Skylar/excelize" /></p>
[Excelize](https://github.com/xuri/excelize) 是 Go 语言编写的用于操作 Office Excel 文档基础库,基于 ECMA-376,ISO/IEC 29500 国际标准。可以使用它来读取、写入由 Microsoft Excel™ 2007 及以上版本创建的电子表格文档。支持 XLSX / XLSM / XLTM 等多种文档格式,高度兼容带有样式、图片(表)、透视表、切片器等复杂组件的文档,并提供流式读写 API,用于处理包含大规模数据的工作簿。可应用于各类报表平台、云计算、边缘计算等系统。入选 2020 Gopher China - Go 领域明星开源项目(GSP)、2018 年开源中国码云最有价值开源项目 [GVP](https://gitee.com/xurime/excelize) (Gitee Most Valuable Project),目前已成为 Go 语言最受欢迎的 Excel 文档基础库。
## 开源代码
**GitHub:** [github.com/xuri/excelize](https://github.com/xuri/excelize)
**Gitee:** [gitee.com/xurime/excelize](https://gitee.com/xurime/excelize)
**中文文档:** [xuri.me/excelize/zh-hans](https://xuri.me/excelize/zh-hans/)
2021年4月19日,社区正式发布了 2.4.0 版本,该版本包含了多项新增功能、错误修复和兼容性提升优化。下面是有关该版本更新内容的摘要,完整的更改列表可查看 [changelog](https://github.com/xuri/excelize/compare/v2.3.2...v2.4.0)。
此版本中最显著的变化包括:
### 兼容性提示
升级至该版本需要您使用的 Go 语言为 1.15 或更高版本。
### 新增功能
* 新增 `GetCellRichText` API,支持根据给定的工作表名称获取富文本
* `SetPageLayout` 和 `GetPageLayout` 现已支持设置和获取页面打印缩放比例、指定单色打印、起始页码
* `SetSheetPrOptions` 和 `GetSheetPrOptions` 现已支持设置和获取工作表标签页颜色
* `SetCellHyperLink` 支持设置屏幕提示文字与显示文字,相关 issue [#790](https://github.com/xuri/excelize/issues/790)
* 创建数据透视表时新增支持 `ShowError` 选项
* 流式 API 支持设置单元格公式, 相关 issue [#625](https://github.com/xuri/excelize/issues/625)
* 公式计算引擎支持不等于运算符
* 嵌套公式函数现在支持将单元格引用用作参数
* 支持指定是否设置图表数据系列格式为自动填充颜色
* 新增 152 项公式函数支持: ATAN, AVERAGE, AVERAGEA, BESSELI, BESSELJ, BIN2DEC, BIN2HEX, BIN2OCT, BITAND, BITLSHIFT, BITOR, BITRSHIFT, BITXOR, CHAR, CHOOSE, CLEAN, CODE, COLUMN, COLUMNS, COMPLEX, CONCAT, CONCATENATE, COUNT, COUNTBLANK, CUMIPMT, CUMPRINC, DATE, DATEDIF, DB, DDB, DEC2BIN, DEC2HEX, DEC2OCT, DOLLARDE, DOLLARFR, EFFECT, ENCODEURL, EXACT, FALSE, FIND, FINDB, FISHER, FISHERINV, FIXED, FV, FVSCHEDULE, GAMMA, GAMMALN, HARMEAN, HEX2BIN, HEX2DEC, HEX2OCT, HLOOKUP, IF, IFERROR, IMABS, IMAGINARY, IMARGUMENT, IMCONJUGATE, IMCOS, IMCOSH, IMCOT, IMCSC, IMCSCH, IMDIV, IMEXP, IMLN, IMLOG10, IMLOG2, IMPOWER, IMPRODUCT, IMREAL, IMSEC, IMSECH, IMSIN, IMSINH, IMSQRT, IMSUB, IMSUM, IMTAN, IPMT, IRR, ISTEXT, ISPMT, KURT, LARGE, LEFT, LEFTB, LEN, LENB, LOOKUP, LOWER, MAX, MID, MIDB, MIN, MINA, MIRR, N, NOMINAL, NORM.DIST, NORMDIST, NORM.INV, NORMINV, NORM.S.DIST, NORMSDIST, NORM.S.INV, NORMSINV, NOT, NOW, NPER, NPV, OCT2BIN, OCT2DEC, OCT2HEX, PDURATION, PERCENTILE.INC, PERCENTILE, PERMUT, PERMUTATIONA, PMT, POISSON.DIST, POISSON, PPMT, PROPER, QUARTILE, QUARTILE.INC, REPLACE, REPLACEB, REPT, RIGHT, RIGHTB, ROMAN, ROW, ROWS, SHEET, SKEW, SMALL, STDEV, STDEV.S, STDEVA, SUBSTITUTE, T, TODAY, TRIM, TRUE, UNICHAR, UNICODE, UPPER, VAR.P, VARP, VLOOKUP
### 兼容性提升
* 当以 `nil` 作为值调用 `SetCellValue` 设置单元格的值时,不再为单元格设置空白字符串而以空值代替,解决 issue [#756](https://github.com/xuri/excelize/issues/756)
* 移除内部处理单元格填充颜色样式时冗余的 XML 可选空值解析标识
* 提升与 Google Sheets 离线浏览器扩展应用程序的兼容性,相关 issue [#769](https://github.com/xuri/excelize/issues/769)
* 在筛选器对应的名称中使用绝对引用以提升与 Apache OpenOffice 应用程序的兼容性,解决 issue [#776](https://github.com/xuri/excelize/issues/776)
* 在流式解析工作表过程中增加 XML 标签关闭事件的处理,提升行/列迭代器读取性能,修复部分情况下读取行数有误的问题
* 提高工作簿内工作表文档使用相对路径的兼容性
* 避免创建重复的富文本样式,解决 issue [#787](https://github.com/xuri/excelize/issues/787)
* 提高工作簿内工作表文档使用绝对路径与 Windows 目录分隔符的兼容性
### 问题修复
* 修复数值舍入精度问题 [#764](https://github.com/xuri/excelize/issues/764)
* 添加并调整工作表字段的解析顺序,修复部分情况下生成的文档损坏的问题 [#766](https://github.com/xuri/excelize/issues/766)
* 修复 `COTH` 双曲余切三角函数计算有误的问题
* 公式计算链增加对工作表的关联处理,修复部分情况下复制行导致的文档损坏问题,解决 issue [#774](https://github.com/xuri/excelize/issues/774)
* 删除工作表时增加对名称的处理,解决 issue [#775](https://github.com/xuri/excelize/issues/775)
* 修复内部函数 `newFills` 和 `parseToken` 圈复杂度过高的问题
* 修复对工作表默认自定义行高的检查
* 修复取消工作表中全部合并单元格时导致文档损坏的问题, 解决 issue [#782](https://github.com/xuri/excelize/issues/782)
* 修复部分情况下筛选条件部分丢失的问题
* 修复当工作簿包含图表工作表、对话工作表时,`UpdateLinkedValue` 产生错误的问题
* 修复部分情况下 `GetColWidth` 返回默认列宽错误的问题
* 修复无法通过 Excel 电子表格应用程序向创建的数据透视表中添加时间轴与切片器的问题,解决 issue [#804](https://github.com/xuri/excelize/issues/804)
* 设置名称时内部的 `localSheetId` 属性将使用 `sheetIndex`,修正错误的工作表索引使用
* 修复部分情况下保存后的文档单元格锁定或隐藏属性可能丢失问题,解决 issue [#809](https://github.com/xuri/excelize/issues/809)
* 修复流式写入数据后调用普通 API 将导致流式写入的丢失问题,解决 issue [#813](https://github.com/xuri/excelize/issues/813)
* 修复负值图表数据系列填充颜色丢失问题
### 性能优化
* 提高了数值精度处理速度
### 其他
* Go Modules 依赖模块更新
* 单元测试与文档更新
* 包含简体中文、英语、法语、俄语、日语、韩语、阿拉伯语、德语和西班牙语的[多国语言文档网站](https://xuri.me/excelize)更新
* 欢迎加入 [Slack 频道](https://join.slack.com/t/xuri/shared_invite/zt-eriqdkeo-wV04zcCdBiiZveFgY86Wzw)、[Telegram 群组](https://t.me/excelize) 或技术交流群
DingTalk Group ID: [`30047129`](https://qr.dingtalk.com/action/joingroup?code=v1,k1,2oHMIIOyvPcGezVdHJjsHwdZzzYNI6xs3Oww8uhlvCk=&_dt_no_comment=1&origin=11)
QQ Group ID: [`207895940`](https://jq.qq.com/?_wv=1027&k=5imdV9h)
<img width="500" src="https://xuri.me/excelize/zh-hans/images/group@2x.png" alt="Excelize 技术交流群">
有疑问加站长微信联系(非本文作者)