@error 仅校验 Sass 变量类型与语义,不校验 CSS 值合法性;需配合 meta.type-of 和自定义函数(如 _is-color)前置判断,并在计算前触发,否则无效。

@error 不会校验 CSS 属性值本身是否合法,只校验 Sass 变量或参数在编译前的类型与业务语义是否匹配。它不能阻止 color: invalid-value 这类 CSS 错误,但能拦住 $color: "red" 这种传参错误——后者会导致后续颜色函数(如 lighten($color, 10%))直接编译失败。
用 meta.type-of 做前置类型判断再触发 @error
直接写 @if $val == null { @error "required" } 是危险的:未声明变量、空字符串 ""、空 map () 都不是 null,会绕过检查。必须先确认类型,再结合语义拦截。
-
@if meta.type-of($val) != "color"比@if not $val安全得多——$val: #fff和$val: 0都是 truthy,但只有前者能进颜色逻辑 - 对单位敏感的场景(如
font-size),要同时判类型和单位:@if meta.type-of($size) == "number" and not _is-length($size)才报错,否则16px和calc(1rem + 4px)会被误杀 - 别在
@error插值里用未定义变量,比如@error "Key #{$key} not found"—— 若$key根本没声明,Sass 会先报Undefined variable "$key",你的错误信息根本不会出现
为什么 _is-color 和 _is-length 必须配合 @error 显式使用
这些验证函数只是返回 true/false,不自动中断流程。它们不关心变量是否存在,也不区分 null 和未定义,更不会抛出上下文明确的错误信息。
-
_is-color("red")返回false,但你不知道是传了字符串、关键字,还是压根没传;而@if not _is-color($color) { @error "Expected color, got #{$color} (#{meta.type-of($color)})" }能暴露真实类型 -
_is-length(16)返回false,但它不告诉你该用16px还是var(--space-md);加@error后可以提示“单位缺失,请补 px/em/rem 或使用 calc()” - 所有 Bourbon 风格的
_is-*函数都需手动包裹@if+@error,没有“开箱即用”的校验机制
常见报错被忽略的三个实际原因
写了 @error 却没看到中断?大概率卡在这几个环节:
- 用的是 Node Sass 4.x 或更早版本——它根本不识别
@error,会直接报Invalid CSS after "@error": expected "{", was '"Color is requi...'。运行sass --version确认输出含dart-sass - Webpack 项目中
sass-loader默认吞掉原始错误堆栈,需显式配置sassOptions: { quietDeps: false }并开启sourceMap -
@error写在未被引用的文件里(比如_utils.scss只写了校验逻辑但没被@use或@import),那整段代码根本不会执行
最常被跳过的一步是:把类型校验放在计算或输出之后。比如先写 $adjusted: lighten($color, 10%) 再判 @if not _is-color($color) —— 此时编译早已在 lighten() 调用时报错退出,你的 @error 根本没机会执行。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











