草庐IT

Excelize 2.7.0 发布, 2023 年首个更新

xuri 2023-03-28 原文

Excelize 是 Go 语言编写的用于操作 Office Excel 文档基础库，基于 ECMA-376，ISO/IEC 29500 国际标准。可以使用它来读取、写入由 Microsoft Excel™ 2007 及以上版本创建的电子表格文档。支持 XLAM / XLSM / XLSX / XLTM / XLTX 等多种文档格式，高度兼容带有样式、图片(表)、透视表、切片器等复杂组件的文档，并提供流式读写 API，用于处理包含大规模数据的工作簿。可应用于各类报表平台、云计算、边缘计算等系统。入选 2020 Gopher China - Go 领域明星开源项目(GSP)、2018 年开源中国码云最有价值开源项目 GVP (Gitee Most Valuable Project)，目前已成为 Go 语言最受欢迎的 Excel 文档基础库。

开源代码

GitHub: github.com/xuri/excelize

Gitee: gitee.com/xurime/excelize

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

2023年1月9日，社区正式发布了 2.7.0 版本，该版本包含了多项新增功能、错误修复和兼容性提升优化。下面是有关该版本更新内容的摘要，完整的更改列表可查看 changelog。

版本说明

此版本中最显著的变化包括：

兼容性提示

  • 升级至该版本需要您使用的 Go 语言为 1.16 或更高版本，以迁移不再支持的标准库 ioutil
  • 当给定工作表名称中存在无效字符时将返回错误，不再自动忽略无效字符
  • GetCellStyle 函数不再返回合并单元格区域左上角单元格的样式
  • 重命名以下 5 个导出数据类型和错误常量，具体更改详见官方文档中的更新说明
  • 移除了 54 项导出类型，具体更改详见官方文档中的更新说明
  • 移除了 2 个导出常量：OrientationPortrait 和 OrientationLandscape
  • 修改了以下 21 个函数的签名，使用结构体引用代替此前以 JSON 格式表示的选项参数，具体更改详见官方文档中的更新说明
  • 引入了 8 项新的函数代替现有函数，具体更改详见官方文档中的更新说明
  • 在 CellType 枚举值中添加 CellTypeFormula, CellTypeInlineString, CellTypeSharedString 并移除了 CellTypeString
  • 对添加批注 AddComment 函数的签名进行了更改，支持创建富文本批注，相关 issue #1204
  • 当 XML 反序列化异常时将返回错误以代替输出日志，函数 GetComments, GetDefaultFont 和 SetDefaultFont 增加了 error 类型的错误返回值

新增功能

  • 新增 GetDataValidations 和 GetConditionalFormats 函数以支持获取数据验证设置和条件格式，相关 issue #827
  • 新增 ProtectWorkbook 和 UnprotectWorkbook 以提供工作簿保护设置支持
  • 新增 SetSheetCol 函数以支持按列设置单元格的值，相关 issue #1247
  • 新增 GetColStyle 函数以支持设置列样式，相关 issue #1293
  • 新增 SetSheetBackgroundFromBytes 函数以支持根据给定的图片数据设置工作表背景图片，相关 issue #1405
  • 新增导出变量 IndexedColorMapping 以支持内建索引颜色转换
  • 新增 20 项导出类型: AutoFilterListOptions, AutoFilterOptions, Chart, ChartAxis, ChartDimension, ChartLegend, ChartLine, ChartMarker, ChartPlotArea, ChartSeries, ChartTitle, ConditionalFormatOptions, PaneOptions, Panes, GraphicOptions, Shape, ShapeColor, ShapeLine, ShapeParagraph 和 TableOptions
  • 新增 2 项公式函数: AGGREGATE 和 SUBTOTAL
  • Save、Write 和 WriteTo 函数支持指定保存选项，相关 issue #744
  • 使用 AddChart 函数添加图表时，支持为折线图设置是否使用平滑折线，相关 issue #1290
  • 使用 AddChart 函数添加图表时，支持设置自定义折线图线条颜色，相关 issue #1345
  • 使用 AddChart 函数添加图表时，支持设置自定义坐标轴字体样式，相关 issue #320
  • 添加图表函数 AddChart 支持创建三维折线图
  • 以下函数新增并发安全支持：SetColWidth、GetColWidth、SetColVisible、GetColVisible、SetColStyle 和 GetColStyle
  • 设置样式时，当给定的样式 ID 不存在时将返回错误，相关 issue #1323
  • 流式按行赋值时，若行号未递增将返回错误，以避免生成的工作簿损坏，相关 issue #1139
  • 按行流式写入工作表时，支持通过指定 RowOpts 为单元格设置样式，相关 issue #1354
  • 支持流式设置窗格，相关 issue #1047
  • 支持流式设置行内富文本单元格
  • 支持流式插入分页符
  • 新增 7 项导出错误信息: ErrUnprotectWorkbook、ErrUnprotectWorkbookPassword、ErrStreamSetPanes、ErrSheetNameBlank、ErrSheetNameInvalid、ErrSheetNameLength 和 ErrSheetNameSingleQuote，以便开发者可根据不同的错误类型进行采取相应处理
  • 新增 5 项导出数据类型: HeaderFooterOptions、PageLayoutMarginsOptions、PageLayoutOptions、SheetPropsOptions 和 ViewOptions
  • 支持设置分级显示的明细数据方向
  • 支持读取和设置单元格字体的主题颜色和色调，相关 issue #1369
  • 支持读取带有符合 ISO 8061 标准的时间类型单元格的值
  • 支持设置和读取带有内建颜色索引的字体颜色
  • 工作簿关闭函数将清理由流式写入器生成的磁盘缓存文件
  • 支持添加或删除列时自动调整受影响的列样式
  • 通过 AddPicture 添加图片时，现已允许插入 SVG 格式图片

兼容性提升

  • 流式写入单元格时将以行内字符类型存储字符型单元格的值，相关 issue #1377
  • 保存工作簿时将跳过工作表中的不带有样式和属性的空白行，以减少生成文档的体积，相关 issue #1383

问题修复

  • 修复部分情况下读取带有内建数字格式样式的浮点数精度有误问题，解决 issue #1328，#1368 和 #1373
  • 修复部分情况下读取带有 AM/PM 数字格式样式的单元格有误问题，解决 issue #1338
  • 修复部分情况下删除批注时由于数组下标越界导致的 panic，解决 issue #1343
  • 修复部分情况下读取单元格的值时出现 panic 的问题，解决 issue #1384 和 #1415
  • 修复部分情况下误将文本解析为浮点型数值的问题，解决 issue #1360
  • 修复使用空字符创建工作表后生成的工作簿损坏问题，解决 issue #1361
  • 修复向工作表添加图片后，获取该图片内容为空的问题
  • 修复部分情况下插入行列后生成的工作簿损坏问题
  • 删除单元格公式时将删除公式计算链中的共享单元格引用，以修复部分情况下生成的文档损坏问题
  • 修复部分情况下未对工作表名称特殊字符及长度做正确处理的问题，解决 issue #1328
  • 修复部分情况下公式函数 OR 计算结果有误的问题
  • 修复在带有单一单元格区域引用的工作表中插入行列时，将收到异常的问题
  • 修复获取带有单一单元格区域引用合并单元格区域时，收到异常的问题
  • 修复部分情况下读取富文本单元格的值不完整问题
  • 修复流式写入时未转义 XML 字符导致的文档损坏问题，解决 issue #1391
  • 修复公式计算函数 ADDRESS 在工作表名称为空时计算结果有误的问题，解决 issue #1396
  • 修复部分情况下添加图片结果有误的问题，解决 issue #1404

性能优化

  • 提高流式合并单元格性能，相较于上一版本，耗时最高降低约 90%，内存使用最高减少约 86%
  • 优化按行流式写入工作表 SetRow 函数的性能，相较于上一版本，耗时最高降低约 19%

其他

  • Go Modules 依赖模块更新
  • 单元测试与文档更新
  • 优化内部变量与函数命名
  • 包含简体中文、英语、法语、俄语、日语、韩语、阿拉伯语、德语和西班牙语的多国语言文档网站更新

致谢

感谢 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)

欢迎加入 Slack 频道、Telegram 群组 或技术交流群 DingTalk Group ID: 30047129 QQ Group ID: 207895940

Excelize2023codeliissueGo

有关Excelize 2.7.0 发布, 2023 年首个更新的更多相关文章

  1. ruby-on-rails - 如何验证 update_all 是否实际在 Rails 中更新 - 2

    给定这段代码defcreate@upgrades=User.update_all(["role=?","upgraded"],:id=>params[:upgrade])redirect_toadmin_upgrades_path,:notice=>"Successfullyupgradeduser."end我如何在该操作中实际验证它们是否已保存或未重定向到适当的页面和消息？ 最佳答案 在Rails3中，update_all不返回任何有意义的信息，除了已更新的记录数(这可能取决于您的DBMS是否返回该信息)。http://ar.ru

  2. ruby-on-rails - 使用 rails 4 设计而不更新用户 - 2

    我将应用程序升级到Rails4，一切正常。我可以登录并转到我的编辑页面。也更新了观点。使用标准View时，用户会更新。但是当我添加例如字段:name时，它​​不会在表单中更新。使用devise3.1.1和gem'protected_attributes'我需要在设备或数据库上运行某种更新命令吗？我也搜索过这个地方，找到了许多不同的解决方案，但没有一个会更新我的用户字段。我没有添加任何自定义字段。 最佳答案 如果您想允许额外的参数，您可以在ApplicationController中使用beforefilter，因为Rails4将参数

  3. 世界前沿3D开发引擎HOOPS全面讲解——集3D数据读取、3D图形渲染、3D数据发布于一体的全新3D应用开发工具 - 2

    无论您是想搭建桌面端、WEB端或者移动端APP应用，HOOPSPlatform组件都可以为您提供弹性的3D集成架构，同时，由工业领域3D技术专家组成的HOOPS技术团队也能为您提供技术支持服务。如果您的客户期望有一种在多个平台（桌面/WEB/APP，而且某些客户端是“瘦”客户端）快速、方便地将数据接入到3D应用系统的解决方案，并且当访问数据时，在各个平台上的性能和用户体验保持一致，HOOPSPlatform将帮助您完成。利用HOOPSPlatform，您可以开发在任何环境下的3D基础应用架构。HOOPSPlatform可以帮您打造3D创新型产品，HOOPSSDK包含的技术有：快速且准确的CAD

  4. ruby-on-rails - 如何在发布新的 Ruby 或 Rails 版本时收到通知？ - 2

    有人知道在发布新版本的Ruby和Rails时收到电子邮件的方法吗？他们有邮件列表，RubyonRails有一个推特，但我不想听到那些随之而来的喧嚣，我只想知道什么时候发布新版本，尤其是那些有安全修复的版本。 最佳答案 从therailsblog获取提要.http://weblog.rubyonrails.org/feed/atom.xml 关于ruby-on-rails-如何在发布新的Ruby或Rails版本时收到通知？，我们在StackOverflow上找到一个类似的问题：

  5. 华为OD机试用Python实现 -【明明的随机数】 2023Q1A - 2

    华为OD机试题本篇题目：明明的随机数题目输入描述输出描述：示例1输入输出说明代码编写思路最近更新的博客华为od2023|什么是华为od，od薪资待遇，od机试题清单华为OD机试真题大全，用Python解华为机试题|机试宝典【华为OD机试】全流程解析+经验分享,题型分享,防作弊指南华为o

  6. objective-c - 在设置 Cocoa Pods 和安装 Ruby 更新时出错 - 2

    我正在尝试为我的iOS应用程序设置cocoapods但是当我执行命令时:sudogemupdate--system我收到错误消息:当前已安装最新版本。中止。当我进入cocoapods的下一步时:sudogeminstallcocoapods我在MacOS10.8.5上遇到错误:ERROR:Errorinstallingcocoapods:cocoapods-trunkrequiresRubyversion>=2.0.0.我在MacOS10.9.4上尝试了同样的操作，但出现错误:ERROR:Couldnotfindavalidgem'cocoapods'(>=0),hereiswhy:U

  7. ruby-on-rails - Rails Associations 的更新方法是什么？ - 2

    这太简单了，太荒谬了，我在任何地方都找不到关于它的任何信息，包括API文档和Rails源代码:我有一个:belongs_to关联，我开始理解当您没有关联时您在Controller中调用的正常模型方法与您有关联时调用的方法略有不同。例如，我的关联在创建Controller操作时运行良好:@user=current_user@building=Building.new(params[:building])respond_todo|format|if@user.buildings.create(params[:building])#etcetera但我找不到关于更新如何工作的文档:@user

  8. ruby-on-rails - OSX Yosemite 更新破坏了 pow.cx - 2

    升级到OSXYosemite后，我现有的pow.cx安装不起作用。升级到最新的pow.cx无效。通过事件监视器重新启动它也没有成功。 最佳答案 卸载(!)并重新安装解决了这个问题。curlget.pow.cx/uninstall.sh|shcurlget.pow.cx|sh 关于ruby-on-rails-OSXYosemite更新破坏了pow.cx，我们在StackOverflow上找到一个类似的问题： https://stackoverflow.com/q

  9. ruby - 将 Gitlab 从 9.3.7 更新到 9.3.8 安装 re2 时出错 - 2

    我们在Ubuntu14.04和Gitlab9.3.7上运行，运行良好。我们正在尝试更新到Gitlabv9.3.8的最新安全补丁，但它给我们这个错误:Gem::Ext::BuildError:ERROR:Failedtobuildgemnativeextension.currentdirectory:/home/git/gitlab/vendor/bundle/ruby/2.3.0/gems/re2-1.0.0/ext/re2/usr/local/bin/ruby-r./siteconf20170720-19622-15i0edf.rbextconf.rbcheckingformain(

  10. ruby-on-rails - Rails 更新属性 - 2

    我遇到了以下问题。我有一个名为user的模型，它有一个名为activated的列。我试图通过激活的方法更新该值？但它给我错误:验证失败:密码不能为空，密码太短(最少6个字符)这对我来说没有意义，因为我没有接触密码字段!我只想更新激活的列。我把我认为相关的代码放在这里，但如果你认为你需要更多，请问:)非常感谢您!型号:attr_accessor:passwordattr_accessible:name,:email,:password,:password_confirmation,:activatedhas_many:sucu_votesemail_regex=/\A[\w+\-.]+@

随机推荐