vue 打包后 static 中图片路径不对的问题

在做这个 vue-cms 项目时,npm run build 打包部署后,然后 访问 的时候,发现:图片不能正常的显示(包括背景图,logo 之类的),请求的路径都 404 了。我的图片都放在了 static/image 中。

部署后,查看网络请求,发现
原本应该请求 neveryu.github.io/vue-cms/static/login-bg.jpg 的路径,实际的网络请求是: neveryu.github.io/static/login-bg.jpg【ps:虽然我在开发时,图片能正常显示】


没错,其实在我们准备打包项目之前,需要考虑的一个问题是:【我们的项目最终是要部署在根目录还是子目录】

如果是部署在 根目录,并不会出现什么问题,因为你的资源文件放在 static 中,然后你在引用的时候,都是 /static/images/a.png/static/images/login-bg.jpg 这样的路径来引用(不管是 css 中,还是 template 中),这样是不会有任何问题的。

大家看到我这个项目的访问路径,应该就知道,我这是属于 【子目录】 部署的情况。

那么在 子目录 部署的时候,就有可能出现本文要说的这个问题 【vue 打包后 static 中图片路径不对的问题】所以,本文后续内容的前置条件就是 子目录 部署。


【重点内容开始】

  • 首先,你如果要部署在子目录的话,那么,你的 config/index.js 配置中,需要将 assetsPublicPath: '/' 改成 assetsPublicPath: './' => 示例代码 。这一点,应该没什么疑问吧。

然后这个时候,你的代码中,引入 static 中图片的时候,就不能使用 /static/images/a.png 这种绝对路径的形式; (虽然,你在开发环境,使用这种绝对路径的方式仍然没有任何问题,但是你部署后,就会发现,原本应该请求 xxx.com/aaaa/static/... 下面的资源,实际的请求地址是 xxx.com/static/... 就像我文章开头说的那样)。而是要使用相对路径的形式。=> 示例代码 大致如下:

<style scoped lang="stylus">
  .login-container
    background: mix(#494166, #424b50) url('../../../static/image/login-bg.jpg') center no-repeat;
    background-size: cover;
</style>

与此同时呢,由于我们在 css 中使用了相对路径来引入图片。那么,打包后,我们的 css 会抽离出来为一个单独的 css 文件,这个时候, css 和 图片 之间的一个相对路径关系就改变了。为了解决这个问题,我们需要在 build/utils.js 中,增加一个 pablicPath 的配置,示例代码 如下:

if (options.extract) {
  return ExtractTextPlugin.extract({
    use: loaders,
    fallback: 'vue-style-loader',
    publicPath: '../../' // 作用是设置打包过程中提取css的方法
  })
} else {
  return ['vue-style-loader'].concat(loaders)
}

这个时候,就解决了打包后图片路径404的问题了。

我们项目中,不光 style 中会有图片的引用,在 template 中同样会有图片的引用。主要分下面三种情况:

  • style 标签中 background-image (上面示例中已讲解)
  • templateimg 标签中 src
  • templateimg 标签中 v-bind:src

templateimg 标签中 src

这种情况与 style 标签中 background-image 一样,我们使用相对路径就行了。
这里 也有一个例子:

<div slot="header" class="el-card-header">
  <img src="../../../static/image/login-logo.png" alt="">
  <h2 class="login-title">{{$t('login.title')}}</h2>
</div>

【唯一需要值得注意的是,templateimg 标签中 v-bind:src 将不适用这个规则】

templateimg 标签中 v-bind:src

这里 有一个例子:

<div class="avatar-wrapper">
  <img class="user-avatar" :src="avatar">
  <div class="username-wrapper">
    <span class="user-name">{{name}}</span>
    <i class="el-icon-caret-bottom"></i>
  </div>
</div>

这里的 :src="avatar" 中的 avatar 是多少呢?

admin: {
  avatar: './static/image/avatar/0.jpg'
}

直接使用 srcv-bind:src 还是有区别的。

---------------------------(正文完)------------------------------------
一个 vue 的学习交流群,想进来面基的,可以点击这个logoVue学习交流,或者手动search群号:685486827


写在最后: 约定优于配置-------软件开发的简约原则.
-------------------------------- (完)--------------------------------------

我的:
个人网站: https://neveryu.github.io/neveryu/
Github: https://github.com/Neveryu
新浪微博: https://weibo.com/Neveryu

更多学习资源请关注我的新浪微博…

Logo

前往低代码交流专区

更多推荐