不能直接用 @import 拼凑 Design Token,因 Less 默认每次导入都重新解析,导致变量重复声明报错;应分 tokens-base.less(含 !default)、tokens-theme.less(覆盖值)、tokens-public.less(函数封装),并用 extract() 生成 CSS 自定义属性,CI/CD 中通过正则扫描和编译检查防覆盖。

为什么不能直接用 @import 拼凑 Design Token?
Less 的 @import 默认是“每次导入都重新解析”,Token 文件一旦被多处 @import,变量就会重复声明报错——比如 @color-primary 在 button.less 和 modal.less 里各自 @import 'tokens.less',Less 编译器会把它当两个独立作用域处理,最后生成的 CSS 可能出现覆盖混乱或编译失败。
真正可行的方式是用 .less 文件只做「声明」,靠 Less 的 @plugin 或手动控制导入顺序 + !default 机制来构建层级。企业级系统必须区分三类文件:
-
tokens-base.less:只含带!default的原始值,如@color-primary: #0066ff !default; -
tokens-theme.less:覆盖 base,不加!default,用于深色模式等变体 -
tokens-public.less:用.color-primary()函数封装访问,避免直接读变量
.color-primary() 这类函数怎么写才不踩坑?
直接暴露变量名(如 @color-primary)会让下游样式强耦合具体值,改个色值就得全局搜替换。应该用函数封装,把语义和实现解耦:
.color-primary() {
@value: #0066ff;
.-output(@value);
}
.-output(@val) {
color: @val;
}这样调用时写 .color-primary();,既可被 mixins 组合,又便于后期替换成 CSS 自定义属性(--color-primary)而不动业务样式。注意两点:
立即学习“前端免费学习笔记(深入)”;
在发送至付费API前,通过三层压缩预处理提示词;利用本地Ollama模型智能压缩消息并生成历史摘要。
- 函数体内不要用
return——Less 没这语法,靠最后一句输出 - 别在函数里写
@import,会导致嵌套导入不可控 - 如果要支持暗色模式切换,函数得接收
@theme参数,而非硬编码值
如何让 Design Token 同时输出 CSS Custom Properties?
Less 本身不生成 :root { --color-primary: #0066ff; },但可以用 extract() + 循环模拟:
@tokens: color-primary #0066ff, color-error #ff4d4f, spacing-xs 4px;
:root {
.gen-css-vars(@list) when (length(@list) > 0) {
@pair: extract(@list, 1);
@name: extract(@pair, 1);
@val: extract(@pair, 2);
--@{name}: @val;
.gen-css-vars(extract(@list, 2));
}
.gen-css-vars(@tokens);
}这段代码能生成标准 CSS 变量,但要注意:extract() 对中文或连字符命名(如 font-size-lg)容易出错,建议 Token 名统一用英文下划线(font_size_lg),输出时再转 kebab-case;另外,所有值必须是字符串或单位值,不能是计算表达式(@spacing-xs * 2 会失败)。
CI/CD 中如何验证 Token 值未被意外覆盖?
光靠人眼检查 tokens.less 文件不可靠。可以在构建前加一道脚本检查:
- 用
lessc --lint验证语法,但它不报变量覆盖 - 真正有效的是提取所有
@xxx:声明行,用正则统计每个变量出现次数,>1 次就告警 - 更进一步:把
tokens-public.less单独编译成纯 CSS,grep 所有color:行,确认没出现硬编码值(如color: #0066ff),强制走函数调用
这套机制跑在 PR 流程里,比文档约定管用得多。复杂点在于 Less 没有 AST 解析器,所以得靠文本扫描+规则组合,而不是依赖某个“完美插件”。

















