重复CSS的根本原因是@import导致内容重复展开,应改用@use+单一入口全局注入,并配置manualChunks归并第三方CSS,禁用style-resources等隐式重复方案。

重复的 CSS 片段几乎总是因为构建链路中多个地方“各自解析并输出”了同一份 SCSS 内容,而不是共享一份编译结果。根本原因不在语法写错,而在模块引入方式和构建配置没对齐。
SCSS @import 导致每个文件都复制一遍
@import 不是引用,是内容展开——每次遇到就全量插入当前作用域。两个组件都 @import "@/styles/mixins.scss",里面定义的 @mixin flex-center() 就会被编译两次,生成两份相同的 CSS 规则。
- DevTools 的 Elements 面板里能看到同一个
.btn { display: flex; justify-content: center; }被注入多次 - Dart Sass 已在 2026 年正式废弃
@import,Vite + esbuild 构建链对其支持持续弱化,部分更新后直接报错 - 即使路径相同,
@import也不去重;它没有模块概念,只有“文本拼接”
Nuxt/Vite 全局注入配置触发隐式重复
用 @nuxtjs/style-resources 或 vite.config.ts 中的 preprocessorOptions.scss.additionalData 直接注入 SCSS 内容,等价于“每个 <style lang="scss"></style> 块开头都塞一遍 @use "mixins" as *”。结果就是:同一套 %reset-text 在 pages/index.css、components/Button.css、layouts/default.css 里各存一份。
- 检查
nuxt.config.ts的css: []数组是否已声明全局入口(如'~/assets/scss/index.scss') - 确认已完全移除
@nuxtjs/style-resources插件——它无法解决去重,只会加剧体积膨胀 - 禁止在
additionalData里写@use "mixins/flex.scss" as *;只能写@use "@/assets/scss/index.scss" as *,且该index.scss内部必须只用@use+ 别名,禁用任何@import
Rollup/Vite 没把第三方 CSS 归入统一 chunk
多个组件分别 import 'element-plus/dist/index.css' 或 import 'normalize.css',Rollup 默认会把它们分散打进各个 JS chunk 对应的 CSS 文件里,而不是合并进一个 styles.css。
立即学习“前端免费学习笔记(深入)”;
- 在
vite.config.ts或nuxt.config.ts的build.rollupOptions.output.manualChunks中显式配置正则:styles: [/node_modules\/.*\.(css|scss|sass|less)$/i] - 正则必须带
i标志,否则.CSS不匹配 - 不要写成
styles: ['node_modules']——这不会匹配文件后缀,Rollup 直接忽略 - 删掉所有组件/页面中对第三方 CSS 的
import,只保留在唯一入口(如main.ts或app.vue顶部)
PostCSS 插件顺序或能力误判
postcss-discard-duplicates 只删字面完全一致的规则(连空格都不能差),对 margin: 0 和 margin-top: 0; margin-right: 0; 完全无感。真正起效的是 cssnano 的 mergeLonghand 和 mergeRules,但必须确保它在 autoprefixer 之后运行。
- 错误配置:
cssnano在autoprefixer前 → 前缀未补全就压缩,可能误删带前缀的声明 - 正确顺序:
autoprefixer→cssnano,且cssnano启用{ mergeLonghand: true, mergeRules: true } - 跨文件重复靠
postcss-import的skipDuplicates: true,但它必须是 PostCSS 插件链第一个,否则嵌套结构(如&.btn { &--primary {} })在传给postcss-nesting前就被扁平化,导致合并失效
最隐蔽的问题往往藏在“看起来没问题”的地方:某个组件悄悄 @import 了旧文件,某次构建漏掉了 css 数组配置,或者 postcss-import 被插在了 autoprefixer 后面。构建后直接搜 .output/public/_nuxt/ 下的 CSS 文件,找你常用的 mixin 名或选择器,出现次数 >1 就说明还有地方没切干净。


















