@import (reference)是唯一能真正阻止重复CSS输出的方式，因其只注入变量、mixin等逻辑定义，跳过所有顶层样式规则；普通@import则原样复制全部内容，导致同一规则在多个组件中重复输出。
@import (reference) 是唯一能真正阻止重复 CSS 输出的导入方式，不是“可选优化”，而是必须用对的地方就生效、用错就白费。
为什么普通 @import 会导致重复 CSS
当你在多个文件里写 @import "mixins/clearfix.less"，Less 会把整个文件内容原样复制进去——包括 .clearfix { ... } 这类顶层规则。如果 5 个组件都这么干，最终 CSS 里就会出现 5 份一模一样的 .clearfix 声明。
- 错误现象：编译后 CSS 体积异常膨胀，审查元素发现同一类名反复出现
- 根本原因：Less 不做去重，只做文本拼接；
@import默认行为就是“导入并输出” - 典型场景：每个
button.less、card.less都@import "utils.less"，结果.sr-only、.visually-hidden全炸开
@import (reference) 的正确写法和限制
它只注入变量、mixin、函数定义，跳过所有顶层选择器（即不生成任何 CSS），但必须严格遵守语法和作用域规则。
- 修饰符必须紧贴
@import关键字：@import (reference) "mixins/grid.less"✅，@import ( reference ) "..."❌（空格导致失效） - 被导入文件里不能有顶层样式规则，否则会被静默忽略——比如
.reset { margin: 0; }在(reference)下完全不进编译结果 - 变量和 mixin 不会跨文件传递：
A.less用(reference)导入B.less，C.less导入A.less，C里仍无法直接调用B定义的.foo() - 调用时必须在当前作用域内——
@import (reference) "mixins/buttons.less"; .ui-kit { .button(primary); }才有效
哪些文件该加 (reference)，哪些绝对不能加
核心判断标准：这个文件是否“只提供逻辑，不输出样式”。
立即学习“前端免费学习笔记（深入）”；
- 应该加：
variables.less、mixins.less、functions.less、vendor-overrides.less（仅含变量覆盖） - 绝对不能加：
base/reset.less、components/button.less、pages/home.less——这些是靠顺序和层叠生效的样式块，加了(reference)就等于删掉了它们 - 第三方库如 Bootstrap 的
mixins/grid-framework.less可以(reference)导入，但dist/css/bootstrap.css必须用@import (inline)或直接 link
检查是否生效的实操方法
别只看 Less 编译有没有报错，要验证最终 CSS 输出是否干净。
- 搜索生成的 CSS 文件，查关键词如
.clearfix、.sr-only，确认只出现一次 - 对比加
(reference)前后的文件体积，暴涨超 30% 就说明某处漏了修饰符 - 在开发时临时删掉一个组件的
@import，如果对应样式还在，说明它被其他文件重复引入了——这就是(reference)没用对的铁证 - 注意构建工具行为：Webpack 的
less-loader默认支持(reference)，但某些旧版 Gulp 插件需显式启用math或paths配置才认修饰符
最容易被忽略的是：命名空间块（如 .ui-kit { ... }）内部的 @import 不能加 (reference)——那会让本该属于该命名空间的样式彻底消失。作用域隔离和引用控制是两套逻辑，混用就全乱。
