HyperFormula 公式解析新特性：获取命名表达式列表

在电子表格应用中，命名表达式（Named Expressions）是一种强大的功能，它允许用户为复杂的公式或常量定义易于记忆的名称。近期，HyperFormula 在 2.7.0 版本中引入了一项重要功能：通过编程方式获取公式中使用的所有命名表达式列表。这一特性为开发者提供了更精细的公式分析和依赖管理能力。

功能背景

命名表达式在大型表格模型中尤为实用。例如，用户可能定义 SalesTax=0.08 或 TotalRevenue=SUM(B2:B10)，然后在其他公式中直接引用这些名称而非原始值或表达式。然而，在动态修改命名表达式或构建依赖关系图时，开发者需要明确知道哪些公式引用了特定名称。

技术实现

HyperFormula 新增的方法支持两种参数形式：

1. 基于单元格地址：传入工作表内的具体坐标（如 'Sheet1'!A1），返回该单元格公式中引用的所有命名表达式。
2. 基于公式字符串：直接解析传入的公式文本，返回其中包含的命名表达式。

这种双参数设计既保持了与现有 API 的一致性，又提供了灵活性。例如：

// 通过单元格地址获取
const namedExpressions = hyperformula.getNamedExpressionsInFormula('Sheet1!C3');

// 通过公式文本获取
const namedExpressions = hyperformula.getNamedExpressionsInFormula('=SalesTax*Revenue');

底层原理

该功能的实现涉及 HyperFormula 的公式解析引擎：

1. 词法分析阶段：识别公式中的所有标识符
2. 语义分析阶段：将标识符与已定义的命名表达式进行匹配
3. 作用域处理：考虑局部和全局命名表达式的可见性

值得注意的是，返回的列表会过滤掉普通单元格引用和函数名称，仅保留有效的命名表达式。

应用场景

1. 动态重计算优化：当修改某个命名表达式时，可以精准定位受影响公式，避免全表重算
2. 文档生成：自动生成公式依赖关系文档
3. 调试辅助：快速定位因命名表达式变更导致的公式错误
4. 迁移工具：在表格数据迁移时识别命名表达式的依赖关系

最佳实践

对于需要频繁检查命名表达式使用的场景，建议：

• 在开发环境使用公式文本参数快速测试
• 在生产环境使用单元格地址参数确保上下文正确性
• 结合 getAllNamedExpressions() 方法进行交叉验证

这一特性的加入使得 HyperFormula 在公式分析能力上更进一步，为构建复杂的表格应用提供了更强大的基础设施。开发者现在可以更高效地实现公式审计、智能提示和依赖可视化等高级功能。