优化含有大量公式的Excel加载速度

需求：怎样优化含大量Formula的Excel文档加载速度

背景：

当我们需要加载一个包含大量Formula的文档（含FormulaRule等），

默认在导入后，为保证数据完整和正确，SpreadJS会自动重算所有公式，

这样就会导致加载文档的时间变长。

解决方案：

实际上SpreadJS提供了几个可以优化的配置项，以下一一解释：

1、fromJSON的doNotRecalculateAfterLoad属性：

正常情况下，无论是Excel还是SpreadJS，公式计算默认都是实时生效的，因此在导入文档时文档数据已经是统一并正确的，所以这个属性可以告知SpreadJS，不需要在导入后执行重算。

设置这个属性表示开发者清楚最终用户的使用环境，比如不会通过一些第三方控件或插件，导出一些“半成品”的Excel文档。

参考API：https://demo.grapecity.com.cn/spreadjs/help/api/classes/GC.Spread.Sheets.Workbook#tojson

2、Workbook的calcOnDemand配置：

用法：spread.options.calcOnDemand = true;

与fromJSON结合使用的代码示例：

spread.fromJSON(workbookObj, {
    doNotRecalculateAfterLoad:true,
    //ignoreFormula: true
});
spread.options.calcOnDemand = true;

这个属性是用来告诉CalcService（计算引擎），按需求执行计算，而不是每次有数据改变都重算所有的公式。

关联功能：自V13开始，SpreadJS已经可以支持公式追踪，也就是获得单元格之间的引用树，参考示例：

https://gcdn.grapecity.com.cn/showtopic-67982-1-2.html

https://gcdn.grapecity.com.cn/showtopic-67984-1-1.html

3、fromJSON的ignoreFormula参数：

前端受平台所限，物理极限较低，单页面算力有限，所以在一些极端情况下（比如百万量级的Formula），或仅仅只需要数据而不需要导入公式时，可以利用fromJSON的ignoreFormula参数来控制：

参考API：https://demo.grapecity.com.cn/spreadjs/help/api/classes/GC.Spread.Sheets.Workbook#tojson

spread.fromJSON(workbookObj, {
    ignoreFormula: true
});
spread.options.calcOnDemand = true;

4、SpreadJS V14 新版本发布，推出了增量加载的功能，可以大幅减少大量公式文档加载的卡顿时间：

https://demo.grapecity.com.cn/spreadjs/SpreadJSTutorial/features/workbook/incremental-loading/purejs

5、根据实际需要，通过懒加载只展示激活的表单页也是种不错的选择：

spread.import(file, function () {
    const endTime = new Date().getTime(); // 记录导入结束时间
    const timeElapsed = (endTime - startTime) / 1000; // 计算时间差（以秒为单位）
    alert(`导入文件 "${file.name}" 耗时：${timeElapsed}秒`);
}, function (e) {
    console.log(e); // 失败回调函数
}, {
    openMode: GC.Spread.Sheets.OpenMode.lazy
});

API可以参考：https://demo.grapecity.com.cn/spreadjs/help/api/classes/GC.Spread.Sheets.Workbook#import

以上详细Demo可以查看论坛精华帖：https://gcdn.grapecity.com.cn/forum.php?mod=viewthread&tid=74083&page=1&extra=#pid694780

作者: Grapecity.China | 审核：Clark.Pan | 更新时间：2023.12.24