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

本文主要解决

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

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

1. 问题

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

//ip:port/public/springActivity/
复制代码

此时访问：

http://ip:port/public/springActivity/index.html
复制代码

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

http://ip:port/static/css/app.cea07642cd24c0d7a5c4b9b7afc7ff64.css
http://ip:port/static/js/app.815851e87b083afb82bf.js
复制代码

2. 分析

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

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文件中的图片资源路径一致，所以图片可以被正常访问。

background:url(static/img/question_bg.61a2825.png)
复制代码

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

所以使用ExtractTextPlugin插件时还须要配置静态资源路径参数，经过查询资料，得知能够经过添加publicPath:"../../"解决该问题：

if (options.extract) {
  return ExtractTextPlugin.extract({
    use: loaders,
    fallback: 'vue-style-loader',
    publicPath:"../../"                 //添加
  })
}
复制代码

打包部署到特定目录下后访问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字符串，不利于版本控制