详解vue静态资源打包中的坑与解决方案

  本文主要解决:css

  一、vue-cli默认配置打包后部署至特定路径下静态资源路径错误问题;html

  二、静态资源打包使用相对路径后css文件引入图片路径错误问题。vue

1、问题
spring

  vue-cli 脚手架生成的默认打包配置文件状况下运行 npm run build 打包后,部署项目至特定路径下:如://ip:port/public/springActivity/
vue-cli

  此时访问:http://ip:port/public/springActivity/index.html
npm

  index.html 能够正常访问,可是引用的js,css等文件服务器响应均为404,查看引入的资源路径以下:服务器

  http://ip:port/static/css/app.cea07642cd24c0d7a5c4b9b7afc7ff64.css
  http://ip:port/static/js/app.815851e87b083afb82bf.js
app

2、分析
less

  由上能够看出是资源打包路径有误,打包后的资源使用了绝对根目录路径,所以将项目部署到特定目录下,其引入的资源路径没法被正确解析。post

3、解决

  在打包时须要使用相对路径来处理静态资源,更改build中资源发布路径配置(config/index.js, build对象):

  将 assetsPublicPath: '/'  改成  assetsPublicPath: './',再次打包,并将资源部署到特定路径下,而后访问,此时index.html能够正常访问,同时js和css资源也能够正常访问,可是css中引入的assets目录下的大图片资源出错了(服务端404)

4、再分析

  查看引入的图片资源路径以下:http://ip:port/public/springActivity/static/css/static/img/question_bg.61a2825.png

  实际项目中资源路径以下:

index.html static/
 |--js/
  |--*.js |--css/
  |--*.css |--img/
  |--*.png

  很明显图片引入路径有误。分析图片引入路径,发现路径均多了"/static/css"两层目录,

  猜想是css目录下的css文件引入图片路径为"/static/img/question_bg.61a2825.png" ,

  查看css文件,css中引入图片路径以下:background:url(static/img/question_bg.61a2825.png)

5、再解决

  css文件中路径存在问题,确定又是打包哪一个环节资源路径没有配置好,分析打包过程,css是在js中引入的或是写在vue文件中的,css文件首先被less,postcss等处理,处理后会被ExtractTextPlugin处理,ExtractTextPlugin将js中的css所有抽离至app.css文件中。

  首先将options.extract设为false,关闭抽离css功能,再次打包并部署至特定目录,访问:http://ip:port/public/springActivity/index.html,页面正常显示,大功即将告成。

  分析打包后的文件,发现没有了css文件,发现css文件所有在app.js文件中;经过js将css注入 index.html文件中,所以css文件中引入的图片资源路径应该是相对于index.html文件路径的,即:"static/img/question_bg.61a2825.png",这与下面css文件中的图片资源路径一致,所以图片可以被正常访问。

  如今很肯定知道问题出在哪了,即:ExtractTextPlugin抽离css文件时没有转换资源引入路径,致使app.css引入了相对app.css目录为"static/img/ .png"的静态资源,该路径相对index.html即为:static/css/static/img/ .png。

  所以使用ExtractTextPlugin插件时还须要配置静态资源路径参数,经过查询资料,得知能够经过添加publicPath:"../../"解决该问题:须要修改build文件夹下的utils.js代码,如图所示:

  打包部署到特定目录下后访问index.html文件,页面一切正常,app.css文件正常引入,图片资源也正常引入,查看app.css文件引入图片资源方式以下:background:url(../../static/img/question_bg.61a2825.png

  publicPath配置后,css文件中引入的图片文件路径前添加了该路径配置;

  publicPath 属性值为打包后的 app.css文件至index.html文件的相对路径

  图片资源也能够直接放在vue-cli生成的static目录下规避上述问题,可是经过这种方式图片名称中没法增长md5字符串,不利于版本控制。

相关文章
相关标签/搜索