likes
comments
collection
share

vue-cli5 + webpack5 + vue2.6x 打包优化

作者站长头像
站长
· 阅读数 439
项目的版本是基于@vue/cli 5.0.4和webpack@5.73.0

vue-cli5版本已经内置了webpack5，且很多配置都内置化了，换言之，基础打包无需在vue.config.js中配置了，大大简化了配置过程。因为主要是针对项目的优化，所以创建的过程会简略，下面是优化的具体详情。

项目初始化

  • 安装 vue-cli

    npm install -g @vue/cli

  • 创建项目使用vue create xx创建项目，根据自己的项目自行选择即可；初始化项目完毕后，可看到项目的目录结构中已经存在vue.config.js文件了。

    publicPath

    配置打包后的路径，需要注意的一点是当路由是history模式时，路径需要设置为绝对路径，即/而不是./。同时 nginx 需要配置try_files $uri $uri/ /index.html;

    module.exports = defineConfig({
publicPath: process.env.NODE_ENV === 'production' ? '/' : '/',
})

    outputDir

    配置打包文件的存放目录。

    module.exports = defineConfig({
outputDir: 'dist',
})

    productionSourceMap

    是否在生产环境中使用 sourcemap，用于定位到错误源码。(不建议使用，会影响打包速度，且会让人看到自己的代码)

    module.exports = defineConfig({
outputDir: 'dist',
})

    devServer

    配置 api 以及跨域端口等设置。

    module.exports = defineConfig({
devServer: {
  port: 8887,
  hot: true,
  compress: true, // 是否启动压缩 gzip
  proxy: {
    '/api': {
      target: 'http://www.galaxychips.com',
      changeOrigin: true,
      pathRewrite: {
        '^/api': ''
      }
    }
  }
},
})

    css 优化

    创建项目时已经选择了 sass，打包时会自动转化为基础 css，且文件会独立分离出来。所以这里我只引入了一个全局变量文件。

    module.exports = defineConfig({
css: {
  loaderOptions: {
    scss: {
      additionalData: '@import "@/assets/scss/variables.scss";'
    }
  }
},
})

    js 优化

    生产环境下内置的插件已经会处理压缩并用 babel 转化代码的操作。

    cdn 加速

    将公用库改为cdn引入方式，加快访问速度，注入html的插件无需安装，已经内置。externals和cdn常量根据自己的项目而定。（文末会贴出代码）

    module.exports = defineConfig({
chainWebpack: config => {
  if (process.env.NODE_ENV === 'production') {
    config.externals(externals)
    // 通过 html-webpack-plugin 将 cdn 注入到 index.html 之中
    config.plugin('html')
      .tap(args => {
        args[0].cdn = cdn
        return args
      })
  }
}
})

    public/index.html 中需要写入注入代码。

    <head>
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/vuetify@2.6.0/dist/vuetify.min.css">
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@mdi/font@latest/css/materialdesignicons.min.css">
  <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Roboto:ital,wght@0,100;0,300;0,400;0,500;0,700;0,900;1,100;1,300;1,400;1,500;1,700;1,900&display=swap">
  <link rel="stylesheet" href="https://cdn.bootcdn.net/ajax/libs/hover.css/2.3.1/css/hover-min.css">
<% for (var i in htmlWebpackPlugin.options.cdn && htmlWebpackPlugin.options.cdn.css) { %>
  <link rel="stylesheet" href="<%= htmlWebpackPlugin.options.cdn.css[i] %>">
<% } %>
</head>
<body>
  <!-- built files will be auto injected -->
  <% for (var i in htmlWebpackPlugin.options.cdn && htmlWebpackPlugin.options.cdn.js) { %>
    <script type="text/javascript" src="<%= htmlWebpackPlugin.options.cdn.js[i] %>"></script>
  <% } %>
</body>
    注意：我使用的 ui 框架是vuetify，使用 cdn 引入的话就不需要通过 import 引入样式，否则打包时会出错。

    代码分割

    lru-cache是项目中的额外插件，提取为一个单独的 chunk。

    config
  .optimization.splitChunks({
    cacheGroups: {
      styles: {
        name: 'styles',
        test: /\.(s?css|less|sass)$/,
        chunks: 'all',
        priority: 10
      },
      common: {
        name: 'chunk-common',
        chunks: 'all',
        minChunks: 2, // 拆分前必须共享模块的最小 chunks 数。
        maxInitialRequests: 5, // 打包后的入口文件加载时，还能同时加载js文件的数量（包括入口文件）
        minSize: 0, // 生成 chunk 的最小体积（≈ 20kb)
        priority: 1, // 优化将优先考虑具有更高 priority（优先级）的缓存组
        reuseExistingChunk: true // 如果当前 chunk 包含已从主 bundle 中拆分出的模块，则它将被重用，而不是生成新的模块
      },
      vendors: {
        name: 'chunk-vendors',
        test: /[\\/]node_modules[\\/]/,
        chunks: 'all',
        priority: 2,
        reuseExistingChunk: true
      },
      lrucache: {
        name: 'chunk-lrucache',
        test: /[\\/]node_modules[\\/]_?lru-cache(.*)/,
        chunks: 'all',
        priority: 3,
        reuseExistingChunk: true
      }
    }
  })

    gzip压缩

    运行npm install compression-webpack-plugin -D安装压缩插件。

    config.plugin('CompressionPlugin').use('compression-webpack-plugin', [{
  filename: '[path][base].gz',
  algorithm: 'gzip',
  test: /\.js$|\.css$|\.html$/,
  threshold: 10240, // 只处理比这个值大的资源。按字节计算
  minRatio: 0.8 // 只有压缩率比这个值小的资源才会被处理
}])

    整个配置详情如下

    const { defineConfig } = require('@vue/cli-service')
const path = require('path')

// 路径处理方法
function resolve (dir) {
return path.join(__dirname, dir)
}

const externals = [
{
  vue: 'Vue'
},
{
  'vue-router': 'VueRouter'
},
{
  axios: 'axios'
},
{
  vuetify: 'Vuetify'
},
{
  md5: 'MD5'
},
{
  qs: 'Qs'
}
]
const cdn = {
css: [],
js: [
  'https://cdn.jsdelivr.net/npm/vue@2.6.14/dist/vue.min.js',
  'https://cdn.jsdelivr.net/npm/vue-router@3.5.1/dist/vue-router.min.js',
  'https://cdn.jsdelivr.net/npm/axios@0.27.2/dist/axios.min.js',
  'https://cdn.jsdelivr.net/npm/vuetify@2.6.0/dist/vuetify.min.js',
  'https://cdn.jsdelivr.net/npm/md5@2.3.0/dist/md5.min.js',
  'https://cdn.jsdelivr.net/npm/qs@6.11.0/dist/qs.min.js'
]
}

module.exports = defineConfig({
publicPath: process.env.NODE_ENV === 'production' ? '/' : '/',
outputDir: 'dist',
productionSourceMap: false,
lintOnSave: process.env.NODE_ENV !== 'production',
devServer: {
  port: 8887,
  hot: true,
  compress: true, // 是否启动压缩 gzip
  proxy: {
    '/api': {
      target: 'http://www.xxxx.com',
      changeOrigin: true,
      pathRewrite: {
        '^/api': ''
      }
    }
  }
},
css: {
  loaderOptions: {
    scss: {
      additionalData: '@import "@/assets/scss/variables.scss";'
    }
  }
},
configureWebpack: {
  resolve: {
    extensions: ['.vue', '.js', '.json', 'scss', 'css'],
    alias: {
      '@': resolve('src')
    },
    modules: [resolve('src'), 'node_modules']
  },
  module: {
  },
  plugins: [
  ]
},
chainWebpack: config => {
  if (process.env.NODE_ENV === 'production') {
    config.externals(externals)
    // 通过 html-webpack-plugin 将 cdn 注入到 index.html 之中
    config.plugin('html')
      .tap(args => {
        args[0].cdn = cdn
        return args
      })
    config.plugin('CompressionPlugin').use('compression-webpack-plugin', [{
      filename: '[path][base].gz',
      algorithm: 'gzip',
      test: /\.js$|\.css$|\.html$/,
      threshold: 10240, // 只处理比这个值大的资源。按字节计算
      minRatio: 0.8 // 只有压缩率比这个值小的资源才会被处理
    }])
    config
      .optimization.splitChunks({
        cacheGroups: {
          styles: {
            name: 'styles',
            test: /\.(s?css|less|sass)$/,
            chunks: 'all',
            priority: 10
          },
          common: {
            name: 'chunk-common',
            chunks: 'all',
            minChunks: 2, // 拆分前必须共享模块的最小 chunks 数。
            maxInitialRequests: 5, // 打包后的入口文件加载时，还能同时加载js文件的数量（包括入口文件）
            minSize: 0, // 生成 chunk 的最小体积（≈ 20kb)
            priority: 1, // 优化将优先考虑具有更高 priority（优先级）的缓存组
            reuseExistingChunk: true // 如果当前 chunk 包含已从主 bundle 中拆分出的模块，则它将被重用，而不是生成新的模块
          },
          vendors: {
            name: 'chunk-vendors',
            test: /[\\/]node_modules[\\/]/,
            chunks: 'all',
            priority: 2,
            reuseExistingChunk: true
          },
          lrucache: {
            name: 'chunk-lrucache',
            test: /[\\/]node_modules[\\/]_?lru-cache(.*)/,
            chunks: 'all',
            priority: 3,
            reuseExistingChunk: true
          }
        }
      })
  }
}
})
转载自:https://segmentfault.com/a/1190000042253052
评论
请登录