解决webpack中css独立成文件后图片路径错误的问题

说明:此配置针对webpack4+

使用webpack构建项目时将css文件独立出来是常见的做法,在webpack4.0以前是使用extract-text-webpack-plugin,

webpack4.0以后使用mini-css-extract-plugin,这里要讲的是后者

我在mini-css-extract-plugin的filename配置加入了css/路径:

new MiniCssExtractPlugin({
    filename: devMode ? 'css/[name].css' : 'css/[name].[hash].css',
    chunkFilename: devMode ? 'css/[id].css' : 'css/[id].[hash].css',
}),

也就是把独立出来的css文件放入dist下的css文件夹下

然而,build之后发现css中引入的图片并没有正确引入,并且报错了:

 

经过url-loader处理后的图片是导出到了 dist/img/ 目录下

可以看到url是img/webpack.xxx.jpg,而正确的路径应该是 ../img/webpack.xxx.jpg

如果直接把css文件直接放在dist根目录下是没有问题的,但是按照习惯,我们一般会把css文件单独放到一个css文件夹下。

那么我们怎么解决这个问题呢?

在此之前我们先看看网上见得最多的解决方案,也就是在output的配置中加入一个 publicPath: '../' 配置,

我们按照这个配置编译看一下能否解决问题

css中的url路径的确可以了,但是可以看到,控制台出现了更多报错,并且css文件本身也不能正确引入了,因此这种方案在这种情况下是解决不了问题的。

由于output中的publicPatch配置会在所有用相对路径引用资源的地方都将上一个 ‘../’因此导致其他原本正确的路径也错了。

因此正确的解决方案应该是在引入MiniCssExtractPlugin.loader时使用对象方式,并在options目录下添加 publicPath: '../' 配置,这样就只会在css文件中引入的资源中添加 “../”,就不会影响其他文件中的路径了。

    module: {
        rules: [
            {
                test: /\.(sa|sc|c)ss$/,
                use: [
                    devMode?'style-loader':{
                        loader:MiniCssExtractPlugin.loader,
                        options: {
                            publicPath: '../'
                        }
                    },
                    'css-loader',
                    //'postcss-loader',
                    //'sass-loader'
                ]
            },
        ]
    },

配置好后run dev server或者build,就会看到css中的资源正确引入了。

更多配置信息可以参考我之前的博客:多页项目的webpack配置

github仓库地址:https://github.com/SailorCai/muti-page-webpack

 

 

 

 

  • 6
    点赞
  • 7
    收藏
    觉得还不错? 一键收藏
  • 3
    评论
Webpack 是一款非常流行的前端打包工具,它可以将 JavaScript、CSS图片等多种资源文件进行打包,并通过一系列的插件和配置来进行定制化。当我们在开发过程使用 CSS 来设置背景图片时,可能会遇到一些问题,比如路径引用不正确、文件无法被正确加载等。 为了解决Webpack打包CSS背景图片路径引用问题,我们可以采取以下几种方式: 1. 直接使用相对路径 我们可以使用相对路径来引用背景图片。比如,如果我们的 CSS 文件图片文件在同一个目录下,那么可以直接使用相对路径来引用。例如: background-image: url(./bg.png); 这里的 "./" 表示当前目录,后面跟上文件名即可。 2. 配置 publicPath 在打包的时候,Webpack默认会将所有的图片等静态资源放到 output.path 指定的输出目录下,并根据 output.publicPath 配置的路径来进行访问。如果我们在使用背景图片的时候,出现了路径错误问题,可能就是因为 publicPath 配置不正确造的。 我们需要在配置文件设置一个 publicPath,这个路径就是我们最终在浏览器访问静态资源的路径。比如,我们可以将 publicPath 设置为"/static/",那么在 CSS 引用背景图片的时候,可以这样写: background-image: url(/static/bg.png); 3. 使用 url-loader 和 file-loader 我们还可以使用 url-loader 和 file-loader 这两个 Loader 处理背景图片路径问题。url-loader 可以将小于 limit 配置的图片转化为 Data URL,大于 limit 的图片会使用 file-loader 进行处理,最终输出一个单独的图片文件。使用方式如下: { test: /\.(png|jpg|gif|svg)$/, use: [ { loader: 'url-loader', options: { limit: 8192, name: '[name].[hash:7].[ext]', outputPath: 'images/' } } ] } 在以上代码,我们配置了使用 url-loader 处理图片文件,并指定了 limit 为 8192,即小于 8KB 的图片会被转化为 Data URL;大于 8KB 的图片则使用 file-loader 进行处理,并输出至指定目录下。通过这种方式,我们可以避免在 CSS 编写复杂的路径,也可以减少请求次数,提高页面性能。 通过以上几种方式,我们就可以轻松处理Webpack打包CSS背景图片路径引用的问题。基于不同的项目需求和实际情况,我们可以选择其适合自己项目的方式来进行配置。
评论 3
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值