完美解决webpack打包css背景图片路径问题

在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中？？？