vuecli vue.config.js 通用配置

'use strict'

const path = require('path')

const defaultSettings = require('./src/settings.js')

function resolve(dir) {

  return path.join(__dirname, dir)

}

const name = defaultSettings.title

// If your port is set to 80,

// use administrator privileges to execute the command line.

// For example, Mac: sudo npm run

// You can change the port by the following methods:

// port = 9999 npm run dev OR npm run dev --port = 9999

const port = process.env.port || process.env.npm_config_port || 9999 // dev port

// 代理的類型及目标位址

const npmConfigTarget = process.env.npm_config_target

const devEnv = process.env.npm_config_dev_env || 'mock'

const proxyTarget = npmConfigTarget || process.env[`PROXY_TARGET_${devEnv.toUpperCase()}`]

const host = devEnv === 'mock' ? 'localhost' : process.env.DEV_SERVER_HOST

if (devEnv === 'local' && !proxyTarget) {

  throw new Error('請配置環境變量: PROXY_TARGET_LOCAL')

// All configuration item explanations can be find in https://cli.vuejs.org/config/

module.exports = {

  /**

   * You will need to set publicPath if you plan to deploy your site under a sub path,

   * for example GitHub Pages. If you plan to deploy your site to https://foo.github.io/bar/,

   * then publicPath should be set to "/bar/".

   * In most cases please use '/' !!!

   * Detail: https://cli.vuejs.org/config/#publicpath

   */

  publicPath: '/',

  outputDir: 'dist',

  assetsDir: 'static',

  lintOnSave: process.env.NODE_ENV === 'development',

  productionSourceMap: false,

  devServer: {

    host,

    port,

    open: true,

    overlay: {

      warnings: false,

      errors: true

    },

    proxy: {

      '^/': {

        target: proxyTarget,

        secure: false,

        ws: false,

        changeOrigin: true

      }

    }

  },

  configureWebpack: {

    // provide the app's title in webpack's name field, so that

    // it can be accessed in index.html to inject the correct title.

    name: name,

    resolve: {

      alias: {

        '@': resolve('src'),

        'components': resolve('src/components'),

        'api': resolve('src/api'),

        'utils': resolve('src/utils'),

        'constants': resolve('src/constants')

  chainWebpack(config) {

    // it can improve the speed of the first screen, it is recommended to turn on preload

    // config.plugins.delete('preload')  

    config.plugin('preload').tap(() => [

      {

        rel: 'preload',

        // to ignore runtime.js

        fileBlacklist: [ /runtime\..*\.js$/],

        include: 'initial',

      },

    ])

    // when there are many pages, it will cause too many meaningless requests

    config.plugins.delete('prefetch')

    // set svg-sprite-loader

    config.module

      .rule('svg')

      .exclude.add(resolve('src/icons'))

      .end()

      .rule('icons')

      .test(/\.svg$/)

      .include.add(resolve('src/icons'))

      .use('svg-sprite-loader')

      .loader('svg-sprite-loader')

      .options({

        symbolId: 'icon-[name]'

      })

    // set preserveWhitespace

      .rule('vue')

      .use('vue-loader')

      .loader('vue-loader')

      .tap(options => {

        options.compilerOptions.preserveWhitespace = true

        return options

    config

      .when(process.env.NODE_ENV !== 'development',

        config => {

          //根據路由驅動頁面的 runtime 代碼預設情況是包含在 build 後的 app.hash.js 内的，

          //如果我們改動其他路由，就會導緻 runtime 代碼改變。進而不光我們改動的路由對應的頁面 js 會變，

          //含 runtime 代碼的 app.hash.js 也會變，對使用者體驗是非常不友好的。

          //為了解決這個問題要設定 runtime 代碼單獨抽取打包： 但是 runtime 代碼由于隻是驅動不同路由頁面的關系，代碼量比較少，請求 js 的時間都大于執行時間了，是以使用 script-ext-html-webpack-plugin 插件将其内鍊在 index.html 中比較友好。

          config

            .plugin('ScriptExtHtmlWebpackPlugin')

            .after('html')

            .use('script-ext-html-webpack-plugin', [

              {

                // `runtime` must same as runtimeChunk name. default is `runtime`

                inline: /runtime\..*\.js$/,

              },

            ])

            .end()

          config.optimization.splitChunks({

            chunks: 'all',

            cacheGroups: {

              libs: {

                name: 'chunk-libs',

                test: /[\\/]node_modules[\\/]/,

                priority: 10,

                chunks: 'initial', // only package third parties that are initially dependent

              elementUI: {

                name: 'chunk-elementUI', // split elementUI into a single package

                priority: 20, // the weight needs to be larger than libs and app or it will be packaged into libs or app

                test: /[\\/]node_modules[\\/]_?element-ui(.*)/, // in order to adapt to cnpm

              commons: {

                name: 'chunk-commons',

                test: resolve('src/components'), // can customize your rules

                minChunks: 3, //  minimum common number

                priority: 5,

                reuseExistingChunk: true,

            },

          })

          config.optimization.runtimeChunk('single')

        }

      )

      .plugin('define')

      .tap(args => {

        args[0]['__DEV_ENV__'] = JSON.stringify(devEnv)

        return args

  }