Sass 严格一元运算符提案:消除 `$a -$b` 解析歧义与弃用流程详解
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 也一并禁止。但该方案被否决,理由有二:
($a)-$b这种形式被用户解读为二元运算符的可能性远高于$a -$b,歧义风险本来就很小;- 团队希望尽可能限制被弃用的行为范围,减少对现有代码的冲击。
这一取舍体现了 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 使用者的实际影响可归纳为三点:
- 写法层面:从现在起(dart-sass 1.55.0 之后),请避免写
$a -$b、$a +$b这类"单边空格"表达式;若想表达减法/加法,写成$a - $b、$a + $b;若想表达"负的$b",写成$a (-$b)。 - 工具层面:升级后如收到
strict-unary弃用警告,应逐步改写为上述消歧形式,避免在下一个主版本升级时直接遭遇语法错误;使用 JS API 的项目可通过 js-api-doc/deprecations.d.ts 中导出的Deprecation<'strict-unary'>类型对警告进行编程式处理。 - 预期演进:由于这不涉及 CSS 兼容性,该破坏性变更只会随各实现的下一个主版本发布,届时
strict-unary情形将由弃用警告升级为语法错误,最终与提案的SumExpression约束完全一致。