Vue项目打包时图片路径出错解决办法

最近在项目中用到了Vue,在项目打包的时候遇到了背景图片路径出错的问题,经过谷歌一番,发现是在配置的时候对图片的限制大小过小造成的。具体位置在:

// build/webpck.base.conf.js
{
  test: /\.(png|jpe?g|gif|svg)(\?.*)?$/,
  loader: 'url-loader',
  query: {
    limit: 10000,
    name: utils.assetsPath('img/[name].[hash:7].[ext]')
}

就是上面配置中的limit默认设置10000造成的,url-loader的处理规则是:如果文件大小不超过limit设置的值,那么就将图片转为base64的格式。如果超过设置的值,就单独打包到utils.assetsPath(‘img/[name].[hash:7].[ext]’) 这个目录下。

具体到项目而言,也就是说超过10k的图片就会将路径改为static/img/'name'。那么为什么打包后的背景图片路径是访问不到的呢?首先这有一个前提,就是当前图片路径是根据css中的background-image来设置的,而打包后的css目录下只有压缩后的一个css文件,并不存在static目录,所以就产生了找不到图片的问题。

解决方案

  • 将超过10k的图片使用img标签包裹,小于10k的图片使用css的属性来引用。

  • 修改url-loader的limit值

    笔者就是使用此办法解决问题的,但是该方法有个缺陷就是增加的js的体积,因为base64转换的缺点就是增大图片原本的体积,造成加载js时间过长,得不偿失。

  • 使用绝对路径加载图片
    该方法不适合较多图片时的场景,因为每一个图片都会进行一次http请求。所以最好的方案还是第一种。

2018-05-17更新:

现找到更好的办法进行配置,此方法不用修改limit值,可以有效防止图片转为css造成css文件过大的问题。

解决方法参考github pspgbhu的回答。

对于楼主的问题,主要是需要单独为 css 配置 publicPath 。
ExtractTextWebpackPlugin 提供了一个 options.publicPath 的 api,可以为css单独配置 publicPath 。

对于用 vue-cli 生成的项目,dist 目录结构如下:

dist
├── index.html
└── static
    ├── css
    ├── img
    └── js

经常遇见的问题是 css 中 background-image 的相对路径不能正确的引用到 img 文件夹中。但是用 ExtractTextWebpackPlugin 的 publicPath 配置就可以。

更改 build/utils.js 文件中 ExtractTextPlugin 插件的options 配置:

    if (options.extract) {
      return ExtractTextPlugin.extract({
        use: loaders,
        publicPath: '../../',         // 注意配置这一部分,根据目录结构自由调整
        fallback: 'vue-style-loader'
      })
    } else {
      return ['vue-style-loader'].concat(loaders)
    }

参考文章:关于Vue背景图打包之后访问路径错误问题

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • 版权声明:本文为博主原创文章,未经博主允许不得转载。 webpack介绍和使用 一、webpack介绍 1、由来 ...
    it筱竹阅读 11,233评论 0 21
  • 记得2004年的时候,互联网开发就是做网页,那时也没有前端和后端的区分,有时一个网站就是一些纯静态的html,通过...
    阳阳阳一堆阳阅读 3,336评论 0 5
  • Webpack学习总结 此文只是自己学习webpack的一些总结,方便自己查阅,阅读不变,非常抱歉!! 下载安装:...
    Lxs_597阅读 995评论 0 0
  • 一步一步学WebPack2 最近将webpack的使用总结一下,便于下一步的使用。本文通过若干的demo,让你一步...
    wavesnow阅读 577评论 0 5
  • 老是很矛盾,有时候想做点事缓和缓和,有时候又觉得做了也无济于事,毕竟已扎根入土壤后生根发芽的种子,又能如何将其回炉...
    浅溪谷阅读 163评论 0 0