SCSS中@import重复打包问题及迁移@use理由

先说明一个核心结论：@import 导致重复打包不是配置上的失误，而是它本身的设计缺陷——必须迁移到 @use，才是治本之道。

下面拆开讲，为什么 @import 会反复复制同样的样式，以及怎么用 @use 一劳永逸。

为什么 @import 必然引发重复样式

@import 本质上是一种“文本插入”机制：每次遇到它，Sass 就把目标文件的内容原样展开一遍，且不管这个文件是不是已经加载过。举个例子，如果 _variables.scss 被 20 个组件都 @import 了，那它就要被完整编译 20 次。变量、mixin、CSS 声明，全部照单全收，重复塞进输出文件。

实际项目中常见的“病状”包括：

• 打包后的 CSS 体积暴涨（dist/style.css 飙到 2MB+ 都有可能）
• 控制台报 Conflicting order. Following module has been added，样式顺序错乱
• 改了一个变量值，结果部分组件没更新样式——因为缓存了不同的副本

这完全不是 Webpack 或 Vite 的锅，对于 @import 而言，它根本就没有“模块身份”这个概念，没有作用域，也没有去重逻辑，就那么吭哧吭哧地复制粘贴。

@use 如何真正解决重复问题

@use 走的是模块导入路线：每个文件在整个编译过程中只加载一次，后续所有引用都复用同一份编译结果。Sass 编译器会自动识别相同路径的 @use 并合并执行，不会重复劳动。

实操上，建议分几步走：

• 把所有全局变量、函数、mixin 收口到一个单一入口文件，比如 src/styles/index.scss。
• 在这个文件里统一 @use 其他模块：@use 'variables' as vars、@use 'mixins' 等。
• 在构建工具的配置文件（比如 vite.config.ts）里，preprocessorOptions.scss.additionalData 中只注入这一行：@use "@/styles/index.scss" as *。
• 注意 as * 表示把所有成员（变量、mixin、函数）直接提升到全局作用域，这样在组件里就不用写 vars.$color-primary 这类带命名空间的前缀——但仅限这个入口文件这么做。

这样一来，所有组件的 SCSS 文件都指向同一份解析结果，变量不会重复声明，CSS 规则也不会反复生成。

Vite / Webpack 中容易踩的坑

即便换上了 @use，配置不当还是会偷偷摸摸地造成重复。下面这几个坑比较隐蔽：

• 在 main.ts 或 App.vue 里又加了一条 import '@/styles/index.scss' —— 这会触发第二轮 Sass 编译，和 additionalData 注入的内容打架。
• 在 additionalData 里混用了 @import（哪怕只有一处）—— Dart Sass 3.0.0+ 会报 DeprecationWarning，而且那行依然按旧机制展开，照样重复。
• 多个 @use 指向同一个文件，但路径写法不一致（比如 @use '@/styles/variables' 和 @use 'src/styles/variables'）—— Sass 把它俩当成不同的模块，导致重复加载。
• 使用 @forward 时没有加 as *，又在组件里单独 @use 了被转发的子模块——这就破坏了单例语义，又造成重复。

怎么验证是否成功？编译完成后，打开生成的 .css 文件，搜索某个全局变量产出的样式（比如 color: #333），它应该只出现一次，而不是分散在各处。

过渡期兼容处理的关键点

老项目不可能一夜之间全部重写，但也不能放任 @import 继续污染构建。下面几个动作比较务实：

• 优先改造那些被高频引入的文件，比如 variables.scss、mixins.scss，其他低频文件可以暂时放一放。
• 绝对不要在同一个模块里混用 @import 和 @use——Sass 不保证这两者的行为一致，很容易炸出 Undefined variable 这种莫名其妙的错误。
• 可以借助官方迁移工具 sass-migrator module --migrate-deps file.scss 自动做转换，但转换完后一定要人工核对 @forward 里的 show/hide 列表是否合理。
• 如果依赖的第三方 SCSS 库（比如 Bootstrap）还没支持 @use，可以暂时用 @use "bootstrap" with ( $enable-important: false ) 的方式把它包裹起来，避免它内部大量的 @import 外溢。

最后再强调一点：模块路径必须完全一致才能被去重。相对路径、别名路径、绝对路径在 Sass 看来是三个不同的模块，哪怕它们最终指向的是同一个文件，也会被当作三个独立模块分别加载。