Sass 严格一元运算符提案:消除 `$a -$b` 解析歧义与弃用流程详解

原创2026-09-21 23:31:122,214 阅读
文章标签:前端

Sass 严格一元运算符提案:消除 $a -$b 解析歧义与弃用流程详解

本提案(Strict Unary Operators: Draft 1)针对 Sass 中 + 与 - 既可作二元运算符、又可作一元运算符导致的语法歧义,正式禁止 $a -$b 这类"运算符前有空格、后无空格"的写法,并为该行为定义了从弃用警告到语法错误的完整演进流程。读者通过本文可理解该歧义产生的根源、提案的语法层修改(SumExpression 产生式)、备选方案取舍,以及 strict-unary 弃用 ID 在规范与 JS API 中的落地方式。

背景:Sass 语法的两难处境

Sass 一直处于一种尴尬的语法位置:一方面,它必须兼容 CSS 的语法习惯,包括大量使用空格分隔的值列表(space-separated lists);另一方面,它又想以贴近用户直觉的方式提供数学运算,符合其他编程语言和日常数学记号的表达习惯。

这一问题在 - 与 + 这两个运算符上被集中放大,因为它们可以有两种完全不同的角色:

  • 二元运算符(binary):出现在两个操作数之间,如 $a - $b 或 $a + $b;
  • 一元运算符(unary):出现在单个操作数之前,如 -$a 或 -$b。

在绝大多数编程语言中,无论空格如何组合,这两种用法都能被无歧义地解析。但在 Sass 中,像 $a -$b 这样的结构,既可以合理地解析为二元运算 $a - $b,也可以解析为一元运算 $a (-$b)。

规范文档指出,Sass 在实践中的做法是将其解析为二元运算,依据是"空格不应影响运算符的解析"这一逻辑。这个逻辑单独看来是自洽的,但落到实际使用中却会带来令用户意外且不愉快的体验——用户写下 $a -$b 时,直觉往往是把 -$b 当成一个整体(负的 $b),而不是做一次减法。

提案核心:禁止歧义形式,强制用户消歧

针对上述混乱,本提案的做法是彻底禁止歧义情形本身。任何形如 $a -$b 或 $a +$b 的表达式都会产生错误,并在错误信息中建议用户通过以下两种写法之一消除歧义:

  • 写成 $a - $b(两侧都有空格),明确表示使用二元运算符;
  • 写成 $a (-$b)(用括号包裹),明确表示使用一元运算符。

其他结构(如 ($a)-$b)仍然被允许,因为它的二元运算含义足够清晰,不会引起误解。

该行为属于破坏性变更(breaking change),因此与所有此类变更一致,Sass 会先弃用(deprecate)旧行为:由于这不属于 CSS 兼容性问题,破坏性变更不会立即生效,而是要等到各实现的下一个主版本(next major revision)才落地。

备选方案:要求二元运算符两侧均有空格

提案还讨论了另一种方案,即要求二元运算符两侧都有空格,从而连 ($a)-$b 也一并禁止。但该方案被否决,理由有二:

  1. ($a)-$b 这种形式被用户解读为二元运算符的可能性远高于 $a -$b,歧义风险本来就很小;
  2. 团队希望尽可能限制被弃用的行为范围,减少对现有代码的冲击。

这一取舍体现了 Sass 在语法演进上的谨慎原则:只针对真正高歧义、高频踩坑的场景做破坏性变更。

语法层修改:改写 SumExpression 产生式

本提案对规范语法的修改落在 SumExpression(求和表达式)产生式上,这是 SassScript 表达式中处理 +/- 二元运算的层级。修改后的产生式定义如下:

SumExpression ::= (SumExpression ('+' | '-')¹)? ProductExpression

其中脚注 1 明确规定了约束条件:

1: 如果运算符前有空白、但运算符后没有空白,则发出语法错误。

也就是说,产生式本身的结构保持不变(仍然是"SumExpression 加可选运算符加 ProductExpression"的递归形式),但在解析 +/- 记号时新增了一条基于空白分布(whitespace distribution)的规则:

  • 运算符两侧都有空白($a - $b)→ 正常解析为二元运算;
  • 运算符两侧都无空白($a-$b)→ 正常解析为二元运算;
  • 运算符前有空白、后无空白($a -$b)→ 语法错误,提示用户消歧。

这一设计只拦截歧义最严重的单边空格情形,同时保持了 SumExpression 与下方 ProductExpression(乘法/取模层级)的既有关系不变。

弃用流程与 strict-unary 弃用 ID

在实现层面,各 Sass 实现需要在发布下一个主版本之前,先针对上述情形发出**弃用警告(deprecation warning)**而非立即报语法错误,为存量代码提供迁移窗口。

这一弃用在当前仓库中有完整的登记与类型化定义:

  • spec/deprecations.yaml 中登记了 strict-unary 条目,描述为 "Ambiguous + and - operators"(歧义的 + 和 - 运算符),并标注 dart-sass 自 1.55.0 起进入 status: active 的弃用状态;
  • accepted/deprecations-api.md 明确要求本提案改为"发出 ID 为 strict-unary 的弃用警告",并在 JS API 中给出对应类型:
    'strict-unary': Deprecation<'strict-unary'>;
    
  • js-api-doc/deprecations.d.ts 的正式类型声明文件中也保留了同名条目,供依赖 JS 类型定义的开发者识别与过滤该弃用警告。

这意味着在 JavaScript 生态中,开发者可以通过弃用 ID strict-unary 精确捕获、统计或静默这条警告,而不会被其他弃用警告干扰。

从当前规范回看该提案的落点

虽然提案描述的是对 SumExpression 的修改,但可以从当前仓库的规范中确认 SumExpression 在整个表达式体系中的位置与作用:

  • spec/expressions.md 定义了下层 ProductExpression 产生式((ProductExpression ('*' | '%'))? SingleExpression),它是 SumExpression 的右操作数层级;
  • spec/types/calculation.md 定义了把 SumExpression / ProductExpression 作为计算值(calculation value)求值的过程:逐记号遍历 "+"、"-"、"*"、"/",将其构造成嵌套的 CalcOperation;
  • spec/types/list.md 中 SpaceListExpression ::= SumExpression+ 表明 SumExpression 还是空格分隔列表的元素基础,这正是"空格分隔列表"与"数学运算"冲突的语法根源所在。

从源码结构看,提案一旦落地,Sass 解析器将在 SumExpression 层级消费 +/- 记号时增加空白检查,从而在更早的阶段拦截歧义输入,而不是等到语义求值阶段才暴露问题。

对开发者的影响与迁移建议

综合以上分析,本提案对 Sass 使用者的实际影响可归纳为三点:

  1. 写法层面:从现在起(dart-sass 1.55.0 之后),请避免写 $a -$b、$a +$b 这类"单边空格"表达式;若想表达减法/加法,写成 $a - $b、$a + $b;若想表达"负的 $b",写成 $a (-$b)。
  2. 工具层面:升级后如收到 strict-unary 弃用警告,应逐步改写为上述消歧形式,避免在下一个主版本升级时直接遭遇语法错误;使用 JS API 的项目可通过 js-api-doc/deprecations.d.ts 中导出的 Deprecation<'strict-unary'> 类型对警告进行编程式处理。
  3. 预期演进:由于这不涉及 CSS 兼容性,该破坏性变更只会随各实现的下一个主版本发布,届时 strict-unary 情形将由弃用警告升级为语法错误,最终与提案的 SumExpression 约束完全一致。
登录后查看全文
sass