Angular ESLint 规则 no-uncalled-signals 的布尔运算问题解析

问题背景

在 Angular 应用中，ESLint 插件 angular-eslint 提供了一个名为 no-uncalled-signals 的规则，用于检测未调用的信号（Signals）。最近有开发者报告该规则在处理布尔运算时会出现误报情况。

问题表现

当开发者在代码中对信号进行布尔运算时，例如：

const result = someSignal() && otherSignal();

或者

if (someSignal() || otherSignal()) {
  // ...
}

规则会错误地报告这些信号是"未调用"的，尽管它们实际上已经被正确调用。

技术原理

no-uncalled-signals 规则的核心目的是确保信号被正确调用（即添加了括号）。在 Angular 的信号系统中，信号是函数，需要通过调用（添加括号）来获取其值。

该规则原本的实现可能过于简单，没有充分考虑布尔运算等复杂表达式中的信号调用情况，导致在这些场景下产生误报。

解决方案

项目维护团队已经通过提交修复了这个问题。修复的核心思路是：

1. 增强规则的 AST（抽象语法树）遍历逻辑
2. 特别处理逻辑表达式（LogicalExpression）节点
3. 确保在布尔运算上下文中正确识别信号调用

版本更新

该修复已包含在 angular-eslint 的 19.7.1 版本中。开发者可以通过升级到最新版本来解决这个问题。

最佳实践

对于使用 Angular 信号的开发者，建议：

1. 保持 ESLint 插件版本为最新
2. 对于复杂的信号表达式，考虑使用显式的计算信号（computed）来提高可读性
3. 在团队中统一信号使用规范，避免过于复杂的表达式

总结

这个案例展示了静态分析工具在复杂语法场景下的挑战，也体现了开源社区快速响应和修复问题的能力。对于 Angular 开发者而言，及时更新工具链可以避免许多类似的问题。