完美解决webpack打包css背景图片路径问题
(编辑：jimmy 日期: 2024/12/28 浏览：3 次 )
在vue组件的style标签内部有如下一段使用背景图片的css代码
background-image: url("../assets/img/icon_add.png");
在webpack中css-loader的解析配置如下
{
test: /\.(css|less)$/,
exclude: path.resolve(__dirname, 'node_modules'),
use: ['style-loader', 'css-loader', 'less-loader']
}
打包后在dist目录的发现没有css文件。这是因为css文件被转化成了js文件。
此时启动项目，背景图片引入正确，能够正常显示。
2 将css文件提取到单独的文件目录
使用 mini-css-extract-plugin 将css文件单独提取到dist目录下的css目录下。
2.1 loader配置
{
test: /\.(css|less)$/,
exclude: path.resolve(__dirname, 'node_modules'),
use: [MiniCssExtractPlugin.loader, 'css-loader', 'less-loader']
}
2.2 plugin配置
new MiniCssExtractPlugin({
filename: 'css/[name][contenthash].css',
})
打包后，dist目录结构如下
可以看到此时图片在根目录(dist)目录下，但是css文件处在dist/css/目录下。现在来看一下打包后的css文件是如何引用图片的路径。
2.3 打包结果
background-image: url(bb65a86a2fe7669e483a56b970bea421.png);
可以看到在dist/css目录下没有bb65a86a2fe7669e483a56b970bea421.png图片。因此图片无法正常显示。理想的情况是
background-image: url(../bb65a86a2fe7669e483a56b970bea421.png);
3 解决方案
更改loader的配置如下
{
loader: MiniCssExtractPlugin.loader,
options: {
// 当前的css所在的文件相对于打包后的根路径dist的相对路径
publicPath: '../'
}
}, 'css-loader', 'less-loader'
总结
分离css文件导致css背景图片路径错误，解决方案的核心是配置publicPath的值，publicPath的值是css文件所在的文件目录相对于根目录的相对路径值。 比如，根路径是/,css文件所在的目录是/css/，因此相对路径是..
意外问题
为什么webpack打包后，css文件被混入到bundle.js文件中，但是图片没有被混入到bundle.js中？？？
下一篇：纯CSS实现选中商品后右下角显示√号功能