小记 vue 打包,build需要注意的一些事

记录 vue 项目打包的一些事情

首先声明项目都是由 vue-cli 生成;

vue 项目从 dev 切换到 prod 时有很多地方需要注意;

  1. 首先是大家最需要注意的 ajax 切换环节

    以前一开始用 Vue 的时候我是在 build 之后,手动修改 ajax 的请求前缀

    比如现在我使用的 axios,

    axios.defaults.baseURL = 'api' 
    

    但是打包的时候一般都要改动 url,直到我后来知道了 process.env 这个对象,

    使用他可以获取当前的环境(后续还会提到,如何修改这个对象)

    之后就可以轻松的修改 ajax 的基础路径了:

    axios.defaults.baseURL = process.env.NODE_ENV === 'development' ? 'api' : ''
    

    使用该方法能够无需在打包时修改路径,更好地配合 webpack 的 proxyTable;

  2. 与 1 类似的 Vue.config.devtools 同样地使用 process 来解决这个问题,

    Vue.config.devtools = process.env.NODE_ENV === 'development'
    

    该属性是是否能够打开 vue 的 devTools;

    某个小有名气的网站,vue 上线的时候,还是 dev 环境,大家引以为戒吧

  3. sources里的 webpack://

    大家在运行程序的时候可以打开 chrome 的 sources 点击 webpack:// 可以发现这个对象里,有所有在运行的组件,资源的源码;

    这个是为了在 debug 的时候调试,然而在 build 之后这个仍然会存在与 sources 中留下很大的隐患;

    而解决这个的方法就是在 /config/index.js 文件下 build 对象中的productionSourceMap改为:

    productionSourceMap:false
    

    在 build 之前需要检查一下该属性;

  4. build 之后需要相对路径的引用:

    也许大家都知道了,在一般项目 build 之后都会生成一个 index.htm 文件和 一个 static 文件夹,而 static 这个文件夹需要被放置在根目录下,

    index.html 会在决定路径下引用该文件

    如果需要添加模块的话,只需要在 /config/index.js 文件下的 build 对象下,修改 assetsSubDirectory 属性为:

    assetsSubDirectory: 'static/[模块名]'
    

    很多人引用图片, css 时也都是在 static 文件夹里面引用的,所以绝对引用也没有太多的问题;

    回到正题,如果图片,css 都是在 assets文件里面, build 之后的文件需要相对路径的引用,这个情况也是比较多的:

    assetsSubDirectory这个属性可以像我上面说的那样,再修改 assetsPublicPath'./'

    如果还有终极的引用需求,比如我碰到的这个:

    index.html 放置在根目录的模块文件夹下, static 需要放置在根目录的公共static下的模块文件夹下,

    这里需要改的话会比较麻烦,不过我估计没什么人会和我一样碰到这样的要求,

    我就简单讲下,先是修改 /build/webpack.base.conf.js里图片的引用方式,再修改 /build/utils.js里的 assetsPath 函数,使其碰到图片的引用时,添加对应的路径即可;

    特别说明:

    打包后,如果你需要使用相对路径来引用,js,css,图片等资源,而且图片是放在assets中的,那么你一定会碰到图片引用错误的情况,

    解决该情况也比较容易:

    build/utils.js 中大概第47行的样子,修改 ExtractTextPlugin.extract 为:

    return ExtractTextPlugin.extract({
                use: loaders,
                publicPath: '../../', // 仅添加该行即可
                fallback: 'vue-style-loader'
    })
    
  5. 添加自定义的全局变量:

    /build/webpack.dev.conf.js 文件下找到 plugins 里的 DefinePlugin 如下,添加测试:

    new webpack.DefinePlugin({
        'process.env': require('../config/dev.env'),
        'myTest':true
    })
    

    重新启动项目,在 main.js 里面打印该属性:

    console.log(myTest) // true
    

    可以发现 console 里输出了该属性的值 true,同样地在 /build/webpack.prod.conf.js 文件下也可以添加全局变量,

    可以通过改方法来替换本文中 1 里的功能,可以直接改变全局变量,而不是用当前环境来判断;

如果需要压缩vendor文件,可以看我另一篇博客 https://www.cnblogs.com/Grewer/p/9033530.html

基本就这样了,可能还有不完善的地方,如果我发现后续还会再加上;