Webpack 5 默认不识别.css文件,必须配置['style-loader', 'css-loader']才能解析并注入样式;顺序颠倒、漏装loader或缺失rules均会导致Module parse failed报错,生产环境须改用MiniCssExtractPlugin.loader避免FOUC。

Webpack 5 默认完全不识别 .css 文件,import './index.css' 会直接报 Module parse failed: Unexpected token —— 所以“能跑起来”是第一关,不是选功能,而是先让 CSS 不报错、不白屏、开发热更新正常。
为什么 import './xxx.css' 会报 Module parse failed?
Webpack 只认 JS,遇到 .css 后缀就当语法错误扔掉。必须显式告诉它:“这个后缀的文件,交给 css-loader 解析”。但光有 css-loader 不够——它只把 CSS 转成 JS 模块对象,不会自动插到页面里。
- 漏装
css-loader或style-loader:执行yarn add --dev css-loader style-loader -
module.rules里没写test: /\.css$/规则:规则不存在,Webpack 就当没看见这个文件 - 写了规则但
use数组为空,或只写了css-loader:缺少style-loader,样式不会注入 DOM
loader 顺序必须是 ['style-loader', 'css-loader']
Webpack 的 use 数组从右向左执行:css-loader 必须先处理 @import/url(./logo.png),转成模块依赖;style-loader 再把最终解析出的 CSS 字符串注入 标签。
- 顺序颠倒(如
['css-loader', 'style-loader'])→style-loader收到原始 CSS 文本(含未解析的路径),直接抛Cannot read property 'toString' of undefined - 用单
loader字段(如loader: 'css-loader')→ 不支持链式调用,style-loader根本不触发 - 加了
postcss-loader或sass-loader?它们得放在css-loader左边,例如['style-loader', 'css-loader', 'postcss-loader']
生产环境必须换 MiniCssExtractPlugin.loader
style-loader 把 CSS 打进 JS bundle,JS 加载完才插入样式,用户会明显看到首屏白屏(FOUC),且 CSS 无法独立缓存——JS 更新一次,样式也得重下。
- 安装插件:
yarn add --dev mini-css-extract-plugin - rule 中替换:
use: [MiniCssExtractPlugin.loader, 'css-loader'](注意不是style-loader) - plugins 中注册:
new MiniCssExtractPlugin({ filename: 'css/[name].[contenthash:8].css' }) -
MiniCssExtractPlugin.loader在mode: 'development'下直接报错,不能和style-loader混在同一个 rule 里
容易被忽略的细节:publicPath 和 url() 路径 404
CSS 里的 url(./logo.png) 是相对路径,解析基准由 MiniCssExtractPlugin 的 publicPath 决定,而非 Webpack 的 output.publicPath。如果图片 404,大概率是这个没设对。
- 在插件配置中显式指定:
new MiniCssExtractPlugin({ publicPath: '../', filename: 'css/[name].[contenthash:8].css' }) - 或者在
css-loader的options中关掉自动解析:{ url: false },改用file-loader或url-loader单独处理
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











