type-of() 是 sass 唯一可靠的运行时类型检查函数,返回 "number"、"string"、"color" 等字符串;它不识别自定义单位,需配合 unit() 或 unitless() 使用,且仅适用于编译期确定的静态值。

怎么用 type-of() 判断 Sass 变量的真实类型
别信变量名或注释,type-of() 是唯一靠谱的运行时类型检查方式。它返回字符串,比如 "number"、"string"、"color"、"list"、"map"、"null" 或 "bool"。注意:它不识别自定义类型(如 px 单位本身不是类型,10px 的类型仍是 "number")。
常见错误是拿它判断“是不是一个尺寸”,结果发现 type-of(12px) === "number",然后逻辑就崩了——这时候得配合 unit() 或 unitless() 一起用。
-
type-of($val)必须在编译期能确定值,不能用于 CSS 自定义属性或运行时 JS 注入的值 - 对空 map
()返回"map",对空 list()返回"list",二者字面量一样但类型不同,容易混淆 - 颜色字面量如
red、#f00、rgb(255,0,0)全部返回"color",无需额外归一化
为什么 variable-exists() 和 global-variable-exists() 要分开用
前者只查当前作用域(含嵌套 mixin 内声明的局部变量),后者只查全局作用域(即顶层 $var: ...)。混用会导致「明明定义了却报错未定义」。
典型场景是写可配置混合宏:用户可能通过 !default 在全局设 $btn-padding,也可能在调用时传参覆盖。这时你要先确认变量是否存在,再决定用哪个值。
立即学习“前端免费学习笔记(深入)”;
- 局部变量(如
@mixin foo() { $x: 1; @if variable-exists(x) { ... } })无法被global-variable-exists()捕获 - 如果变量在
@import后才定义,且你用global-variable-exists()查它,必须确保 import 顺序正确,否则返回false - 函数内部声明的变量永远不进全局,
global-variable-exists()对它无效
function-exists() 和 mixin-exists() 的真实用途不是“防错”,而是“条件注册”
它们返回布尔值,但真正价值在于配合 @if 实现“仅当某函数存在时才定义另一个函数”。比如你想扩展 lighten() 行为,但又不想破坏旧版 Sass(lighten() 在 3.3+ 才内置),就得先 @if function-exists(lighten) 再包裹。
注意:这两个函数查的是当前编译上下文已加载的函数/mixin,不是字符串名匹配。传入 "lighten" 是对的,传入 lighten(没引号)会报错 Undefined variable "$lighten"。
- 第三方库(如 Compass)的函数需先
@import才能被function-exists()检测到 -
mixin-exists("foo")对未定义的 mixin 返回false,但若@include foo已执行过,再查仍为false—— 它只管声明,不管调用 - 不要用它做运行时分支逻辑(如根据函数存在与否改变样式输出),Sass 编译后无运行时,这类判断必须在编译期完成
写健壮混合宏时,最容易漏掉的类型校验组合
单靠 type-of() 不够。比如想接受一个“合法的间距值”,你要同时检查:type-of($val) == "number" 且 unitless($val) == false 或 unit($val) == "px" or unit($val) == "rem"。漏掉单位检查,12 和 12px 都会过,但语义完全不同。
另一个高频坑是 list 处理:用 type-of($val) == "list" 只能知道它是 list,但不知道是空的、逗号分隔还是空格分隔。得立刻跟上 length($val) 和 list-separator($val)。
- 对 map 类型,务必先
@if type-of($val) == "map",再@if map-has-key($val, "size"),否则map-has-key()对非 map 输入会直接报错 - 所有 introspection 函数都**不支持 CSS 变量**(
var(--color)),它们只工作于 Sass 编译期静态值 - 复杂混合宏建议把类型校验抽成私有函数,比如
@function is-spacing($val),避免每个@include都重复写三行判断
类型检查不是为了炫技,是让错误提前暴露在编译阶段——而不是等浏览器里 margin 突然变成 NaNpx。越早校验,debug 成本越低。










