讲师中心 微信公众号

工具推荐

视频效率加速
AniShort
AniShort

AI短剧协同制作平台

SoundView
SoundView

字幕擦除翻译、配音口型同步

Seko
Seko

AI短剧一键生成成片

剧云
剧云

中文短剧剧本制作平台

为什么构建编译后的CSS会出现重复引入的代码?

梦磊吖_7644

梦磊吖_7644

发布时间:2026-11-17 11:13:47

|

798人浏览过

|

来源于php中文网

原创

重复引入的根源在于构建工具未配置模块去重:Vite需避免混用import与link,Webpack需正确配置splitChunks.cacheGroups匹配CSS后缀,Rollup依赖manualChunks;SCSS必须用@use替代已废弃的@import。

为什么构建编译后的css会出现重复引入的代码?

重复引入的根源在构建时没做模块去重

构建工具(如 Vite、Webpack、Rollup)默认把每个 import './xxx.css' 当作独立模块处理。哪怕路径完全相同,只要 import 出现在两个不同文件里,打包器就可能生成两份 CSS 内容——不是浏览器加载了两次,而是构建产物里已经塞进了两段一模一样的规则。

常见错误现象:

  • DevTools 的 Elements 面板里看到同一段样式(比如 .btn { color: blue; })被注入了两次
  • 构建后 CSS 文件体积异常膨胀,搜索关键词发现多处重复匹配
  • 页面刷新时偶现 FOUC(Flash of Unstyled Content),说明样式注入时机不一致

根本原因不是代码写错了,而是构建配置没告诉打包器:“这些 CSS 应该只出现一次”。Vite 默认对 ES 模块 CSS 有 dedupe,但前提是没混用 HTML <link>;Webpack 则必须靠 SplitChunksPlugin 显式提取;Rollup 完全依赖 manualChunks 配置。

Vite 中 import 多次却没去重?检查是否混入了 HTML link

Vite 的 CSS 去重只作用于 JS 中的 import,对 <link href="xxx.css"> 完全无感。一旦你在 index.html 里手动加了第三方 CSS 的 link,又在 main.ts 或组件里 import 'xxx.css',结果就是浏览器收到两份请求、解析两遍、应用两次。

立即学习“前端免费学习笔记(深入)”;

实操建议:

CSS
CSS

CSS 官方网站入口。访问 W3C 的 CSS 页面,查看 CSS 标准、学习资料与工作组动态;CSS 是 Web 标准,无需下载安装。

下载
  • 删掉 index.html 中所有第三方 CSS 的 <link>,只保留你自己写的全局样式(如 app.css)
  • 确保所有第三方 CSS(如 normalize.css、ant-design/dist/antd.css)只通过 JS import 引入,且仅出现在一个地方(如 main.ts 顶部)
  • 如果用了 @import (css) 在 Less/Sass 中引入纯 CSS 文件,确认它没被 less-loader 二次处理——加 /* webpackIgnore: true */ 注释更保险

Webpack SplitChunks 配置失效?cacheGroups 写法不对

Webpack 的 splitChunks.cacheGroups 必须精确匹配模块路径和类型,否则会跳过提取。很多人写 test: /node_modules/,结果什么都没抽出来——因为正则没限定文件后缀,Webpack 不认为它是“可提取的 CSS 模块”。

正确写法要点:

  • test 必须包含后缀,例如 /\.css$/i 或 /node_modules\/.*\.(css|scss)$/i
  • chunks: 'all' 不能漏,否则只处理 async chunk
  • enforce: true 可强制提取,避免被 size threshold 拦截
  • 第三方 CSS 必须是 import 进来的,而不是通过 style-loader!css-loader!xxx.css 直接 require

错误示例:cacheGroups: { vendor: { test: /node_modules/, name: 'vendors' } } —— 这个只会抽 JS,CSS 仍散落在各 chunk 中。

SCSS @import 导致重复?Dart Sass 已废弃该语法

还在用 @import "mixins/flex"?这不仅是重复打包问题,2026 年 Dart Sass 已正式废弃 @import,Vite 构建链路(基于 esbuild + sass-embedded)遇到它会直接报错或静默降级为文本复制,导致 @mixin 被展开多次、变量被覆盖、%placeholder 失效。

必须改用 @use:

  • 所有 mixin/variable/function 都要从 @use "path" as * 改成显式命名空间,如 @use "mixins/flex" as flex
  • 全局入口(如 src/assets/scss/index.scss)统一 @use 所有依赖,再通过 css: ['~/assets/scss/index.scss'] 注入 Nuxt/Vue 项目
  • 删掉所有组件内的 @import 或 @use ... as *,它们会让同一份 SCSS 内容被重复解析进每个组件的 style 块

最隐蔽的坑是:你以为改了 @use 就安全了,但某个同事在新组件里随手写了 @import "@/assets/scss/_vars.scss"——这一行就足以让整套颜色变量在多个 CSS 文件里重复输出。

热门AI工具

更多
音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

SoundView
SoundView Hot

SoundView是一款面向跨境电商的视频翻译、配音和本地化 AI 创作平台。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
css
css

css是层叠样式表,用来表现HTML或XML等文件样式的计算机语言,不仅可以静态地修饰网页,还可以配合各种脚本语言动态地对网页各元素进行格式化。php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

5836

2023.06.15

css居中
css居中

css居中:1、通过“margin: 0 auto; text-align: center”实现水平居中;2、通过“display:flex”实现水平居中;3、通过“display:table-cell”和“margin-left”实现居中。本专题为大家提供css居中的相关的文章、下载、课程内容,供大家免费下载体验。

1257

2023.07.27

css如何插入图片
css如何插入图片

cssCSS是层叠样式表(Cascading Style Sheets)的缩写。它是一种用于描述网页或应用程序外观和样式的标记语言。CSS可以控制网页的字体、颜色、布局、大小、背景、边框等方面,使得网页的外观更加美观和易于阅读。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2138

2023.07.28

css超出显示...
css超出显示...

在CSS中,当文本内容超出容器的宽度或高度时,可以使用省略号来表示被隐藏的文本内容。本专题为大家提供css超出显示...的相关文章,相关教程,供大家免费体验。

4386

2023.08.01

css字体颜色
css字体颜色

CSS中,字体颜色可以通过属性color来设置,用于控制文本的前景色,字体颜色在网页设计中起到很重要的作用,具有以下表现作用:1、提升可读性;2、强调重点信息;3、营造氛围和美感;4、用于呈现品牌标识或与品牌形象相符的风格。

9245

2023.08.10

什么是css
什么是css

CSS是层叠样式表(Cascading Style Sheets)的缩写,是一种用于描述网页(或其他基于 XML 的文档)样式与布局的标记语言,CSS的作用和意义如下:1、分离样式和内容;2、页面加载速度优化;3、实现响应式设计;4、确保整个网站的风格和样式保持统一。

7811

2023.08.10

css三角形怎么写
css三角形怎么写

CSS可以通过多种方式实现三角形形状,本专题为大家提供css三角形怎么写的相关教程,大家可以免费体验。

2537

2023.08.21

css设置文字颜色
css设置文字颜色

CSS(层叠样式表)可以用于设置文字颜色,这样做有以下好处和优势:1、增加网页的可视化效果;2、突出显示某些重要的信息或关键字;3、增强品牌识别度;4、提高网页的可访问性;5、引起不同的情感共鸣。

3771

2023.08.22

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

140

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn