Univer.js 公式计算模式解析：解决初始化时公式不生效问题

问题现象分析

在使用Univer.js构建业务场景时，开发者可能会遇到一个典型问题：工作表初始化时，某些公式单元格未能正确显示计算结果，需要切换到其他工作表再切换回来才能正常显示。这种现象通常表现为：

1. 工作表首次加载时，公式单元格显示为空白或原始公式文本
2. 手动切换工作表后，公式能够正常计算并显示结果
3. 数据本身没有问题，只是初始渲染时计算未执行

根本原因探究

这种现象的根源在于Univer.js的公式计算模式设计。系统默认采用了一种名为WHEN_EMPTY的计算策略，这是一种性能优化机制。具体表现为：

• WHEN_EMPTY模式：仅对包含公式但值为空(v值为空)的单元格执行计算
• 设计目的：避免在初始化时对全部公式进行不必要的计算，提升大型工作表的加载性能
• 副作用：当工作表已经包含数据时，部分公式可能不会在首次渲染时触发计算

解决方案与实践

针对这一问题，开发者可以通过调整公式计算模式来解决。Univer.js提供了多种计算模式供选择：

1. 全部计算模式：

   {
     formula: {
       calculationConfig: {
         calculationMode: CalculationModelType.ALL
       }
     }
   }
   

   这种模式会在初始化时计算所有公式，确保数据一致性，但可能影响大型工作表的性能。

2. 按需计算模式：

   {
     formula: {
       calculationConfig: {
         calculationMode: CalculationModelType.WHEN_EMPTY
       }
     }
   }
   

   这是默认模式，只计算空值单元格的公式，适合大多数场景。

3. 手动触发模式： 开发者也可以选择在特定时机手动触发公式计算：

   // 获取公式控制器
   const formulaController = univerAPI.get(FormulaController);
   // 手动执行计算
   formulaController.calculate();
   

最佳实践建议

1. 小型工作表：直接使用ALL模式，确保公式立即计算
2. 大型复杂工作表：
   • 保持默认WHEN_EMPTY模式
   • 在数据加载完成后手动触发计算
   • 考虑使用异步计算策略
3. 动态数据场景：监听数据变化事件，在数据更新后触发计算

深入理解计算机制

Univer.js的公式计算系统采用了分层设计：

1. 依赖图构建：系统会分析公式间的引用关系，建立依赖图
2. 脏检查机制：标记需要重新计算的单元格
3. 懒计算策略：根据配置决定何时执行实际计算
4. 结果缓存：避免重复计算相同公式

这种设计在保证功能完整性的同时，提供了良好的性能表现，但需要开发者理解其工作机制才能更好地使用。

总结

通过合理配置Univer.js的公式计算模式，开发者可以平衡计算准确性和性能需求。对于大多数业务场景，理解并正确使用这些配置选项，能够有效解决公式初始化不计算的问题，同时保持应用的良好性能表现。