vue-cli3.0 полная конфигурация

содержание

√ Настройка нескольких переменных среды
√ Базовая конфигурация vue.config.js
√ Настроить междоменный прокси
√ Исправлена ошибка HMR (горячего обновления)
√ Исправить ленивую загрузку маршрутов Ошибка: циклическая зависимость
√ Добавить псевдоним
√ Удалите лишние и недействительные css
√ Добавить анализ пакетов
√ Настройка внешних
√ Удалить console.log
√ Включить сжатие GZIP
√ Обеспечить глобальные стили для sass, а также глобальные переменные
√ Добавить совместимость с IE
√ Загрузка файлов через Ali OSS
√ Полные зависимости

☞ Настройте несколько переменных среды

Выберите различные среды, добавив --mode xxx в элемент конфигурации скриптов в package.json.

Создать .env, .env.production, .env.analyz и другие файлы в корневом каталоге проекта

Доступно только с VUEAPPПеременные в начале будут статически встроены в пакет на стороне клиента с помощью webpack.DefinePlugin, а доступ к коду можно получить через process.env.VUE_APP_BASE_API.

NODE_ENV и BASE_URL — две специальные переменные, которые всегда доступны в коде.

.env обслуживает переменные среды по умолчанию

NODE_ENV = 'development'
VUE_APP_BASE_API = 'https://demo.cn/api'
скопировать код

.env.production сборка переменных среды по умолчанию

Если включен ali oss, VUE_APP_SRC настроил ресурсы префикса URL-адреса ali oss, например: 'staven.oss-cn-hangzhou.aliyuncs.com/demo'

NODE_ENV = 'production'

VUE_APP_BASE_API = 'https://demo.com/api'
VUE_APP_SRC = '/'

ACCESS_KEY_ID = ''
ACCESS_KEY_SECRET = ''
REGION = 'oss-cn-hangzhou'
BUCKET = 'staven'
PREFIX = 'demo'
скопировать код

.env.analyz для анализа упаковки webpack-bundle-analyzer

Если ali oss включен, VUE_APP_SRC настраивается как префикс URL-адреса ресурса ali oss, например: 'staven.oss-cn-hangzhou.aliyuncs.com/demo'

NODE_ENV = 'production'
IS_ANALYZ = 'analyz'

VUE_APP_BASE_API = 'https://demo.com/api'
VUE_APP_SRC = '/'

ACCESS_KEY_ID = ''
ACCESS_KEY_SECRET = ''
REGION = 'oss-cn-hangzhou'
BUCKET = 'staven'
PREFIX = 'demo'
скопировать код

Изменить package.json

"scripts": {
  "serve": "vue-cli-service serve",
  "build": "vue-cli-service build",
  "analyz": "vue-cli-service build --mode analyz",
  "lint": "vue-cli-service lint"
}
скопировать код

▲ вернуться к началу

☞ Основы настройки vue.config.js

const IS_PROD = ['production', 'prod'].includes(process.env.NODE_ENV);

module.exports = {
  baseUrl: './', // 默认'/'，部署应用包时的基本 URL
  outputDir: process.env.outputDir || 'dist', // 'dist', 生产环境构建文件的目录
  assetsDir: '',  // 相对于outputDir的静态资源(js、css、img、fonts)目录
  lintOnSave: false,
  runtimeCompiler: true, // 是否使用包含运行时编译器的 Vue 构建版本
  productionSourceMap: false,  // 生产环境的 source map
  parallel: require('os').cpus().length > 1,
  pwa: {}
};
скопировать код

▲ вернуться к началу

☞ Настроить междоменный прокси

const IS_PROD = ['production', 'prod'].includes(process.env.NODE_ENV);
module.exports = {
    devServer: {
        // overlay: {
        //   warnings: true,
        //   errors: true
        // },
        open: IS_PROD,
        host: '0.0.0.0',
        port: 8000,
        https: false,
        hotOnly: false,
        proxy: {
          '/api': {
            target: process.env.VUE_APP_BASE_API || 'http://127.0.0.1:8080',
            changeOrigin: true
          }
        }
    }
}
скопировать код

▲ вернуться к началу

☞ Исправить сбой HMR (горячее обновление)

module.exports = {
    chainWebpack: config => {
        // 修复HMR
        config.resolve.symlinks(true);
    }
}
скопировать код

▲ вернуться к началу

☞ Исправить ленивую загрузку маршрутов Ошибка: Циклическая зависимостьGitHub.com/v UE JS/v UE — от…

module.exports = {
    chainWebpack: config => {
        config.plugin('html').tap(args => {
            args[0].chunksSortMode = 'none';
            return args;
        });
    }
}
скопировать код

▲ вернуться к началу

☞ Добавить псевдоним

const path =  require('path');
const resolve = (dir) => path.join(__dirname, dir);
const IS_PROD = ['production', 'prod'].includes(process.env.NODE_ENV);

module.exports = {
    chainWebpack: config => {
        // 添加别名
        config.resolve.alias
          .set('@', resolve('src'))
          .set('assets', resolve('src/assets'))
          .set('components', resolve('src/components'))
          .set('layout', resolve('src/layout'))
          .set('base', resolve('src/base'))
          .set('static', resolve('src/static'));
    }
}
скопировать код

▲ вернуться к началу

☞ Удалите избыточный недействительный css

npm i --save-dev glob-all purgecss-webpack-plugin
скопировать код

const PurgecssPlugin = require('purgecss-webpack-plugin');
const glob = require('glob-all');
const path = require('path')

module.exports = {
    configureWebpack: config => {
        if (IS_PROD) {
            const plugins = [];
            plugins.push(
                new PurgecssPlugin({
                    paths: glob.sync([
                    path.join(__dirname, './src/index.html'),
                    path.join(__dirname, './**/*.vue'),
                    path.join(__dirname, './src/**/*.js')
                    ])
                })
            );
            config.plugins = [
                ...config.plugins,
                ...plugins
            ];
        }
    }
}
скопировать код

▲ вернуться к началу

☞ Добавить анализ пакета

const BundleAnalyzerPlugin = require('webpack-bundle-analyzer').BundleAnalyzerPlugin;

module.exports = {
    chainWebpack: config => {
        // 打包分析
        if (process.env.IS_ANALYZ) {
          config.plugin('webpack-report')
            .use(BundleAnalyzerPlugin, [{
              analyzerMode: 'static',
            }]);
        }
    }
}
скопировать код

▲ вернуться к началу

☞ Настройка внешних

Предотвращает объединение некоторых импортированных пакетов в пакеты, но вместо этого получает эти зависимости расширения извне во время выполнения.


module.exports = {
    configureWebpack: config => {
        config.externals = {
          'vue': 'Vue',
          'element-ui': 'ELEMENT',
          'vue-router': 'VueRouter',
          'vuex': 'Vuex',
          'axios': 'axios'
        }
    }
}
скопировать код

▲ вернуться к началу

☞ удалить console.log

метод первый:

const UglifyJsPlugin = require('uglifyjs-webpack-plugin');
module.exports = {
    configureWebpack: config => {
        if (IS_PROD) {
            const plugins = [];
            plugins.push(
                new UglifyJsPlugin({
                    uglifyOptions: {
                        compress: {
                            warnings: false,
                            drop_console: true,
                            drop_debugger: false,
                            pure_funcs: ['console.log']//移除console
                        }
                    },
                    sourceMap: false,
                    parallel: true
                })
            );
            config.plugins = [
                ...config.plugins,
                ...plugins
            ];
        }
    }
}
скопировать код

Способ 2: Использование плагина Babel-Plugin-Transform-Remove-Console

npm i --save-dev babel-plugin-transform-remove-console
скопировать код

Настроить в babel.config.js

const plugins = [];
if(['production', 'prod'].includes(process.env.NODE_ENV)) {
  plugins.push("transform-remove-console")
}

module.exports = {
  presets: [["@vue/app",{"useBuiltIns": "entry"}]],
  plugins: plugins
};

скопировать код

▲ вернуться к началу

☞ Включить сжатие gzip

npm i --save-dev compression-webpack-plugin
скопировать код

const CompressionWebpackPlugin = require('compression-webpack-plugin');
const productionGzipExtensions = /\.(js|css|json|txt|html|ico|svg)(\?.*)?$/i;

module.exports = {
    configureWebpack: config => {
        if (IS_PROD) {
            const plugins = [];
            plugins.push(
                new CompressionWebpackPlugin({
                    filename: '[path].gz[query]',
                    algorithm: 'gzip',
                    test: productionGzipExtensions,
                    threshold: 10240,
                    minRatio: 0.8
                })
            );
            config.plugins = [
                ...config.plugins,
                ...plugins
            ];
        }
    }
}
скопировать код

Вы также можете включить сжатие Zopfli, которое лучше, чем gzip.Веб-пакет.Просто .org/plugins/com…

npm i --save-dev @gfx/zopfli brotli-webpack-plugin
скопировать код

const CompressionWebpackPlugin = require('compression-webpack-plugin');
const zopfli = require("@gfx/zopfli");
const BrotliPlugin = require("brotli-webpack-plugin");
const productionGzipExtensions = /\.(js|css|json|txt|html|ico|svg)(\?.*)?$/i;

module.exports = {
    configureWebpack: config => {
        if (IS_PROD) {
            const plugins = [];
            plugins.push(
                new CompressionWebpackPlugin({
                    algorithm(input, compressionOptions, callback) {
                      return zopfli.gzip(input, compressionOptions, callback);
                    },
                    compressionOptions: {
                      numiterations: 15
                    },
                    minRatio: 0.99,
                    test: productionGzipExtensions
                })
            );
            plugins.push(
                new BrotliPlugin({
                    test: productionGzipExtensions,
                    minRatio: 0.99
                })
            );
            config.plugins = [
                ...config.plugins,
                ...plugins
            ];
        }
    }
}
скопировать код

▲ вернуться к началу

☞ Предоставьте глобальные стили для sass, а также глобальные переменные

Вы можете смонтировать информацию о конфигурации в переменной среды с помощью Vue.prototype.$src = process.env.VUE_APP_SRC; в main.js, а затем использовать $src для доступа к ней в js.

css может использовать введенные переменные sass для доступа к информации о конфигурации в переменных окружения

module.exports = {
    css: {
        modules: false,
        extract: IS_PROD,
        sourceMap: false,
        loaderOptions: {
          sass: {
            // 向全局sass样式传入共享的全局变量
            data: `@import "~assets/scss/variables.scss";$src: "${process.env.VUE_APP_SRC}";`
          }
        }
    }
}
скопировать код

ссылка в ссс

.home {
    background: url($src + '/images/500.png');
}
скопировать код

▲ вернуться к началу

☞ Добавить совместимость с IE

npm i --save @babel/polyfill
скопировать код

добавить в main.js

import '@babel/polyfill';
скопировать код

Настройте babel.config.js

const plugins = [];

module.exports = {
  presets: [["@vue/app",{"useBuiltIns": "entry"}]],
  plugins: plugins
};

скопировать код

▲ вернуться к началу

☞ Загрузка файлов через Ali OSS

Чтобы включить загрузку файлов ali oss, вам нужно изменить baseUrl на префикс URL-адреса ресурса ali oss, то есть изменить VUE_APP_SRC

npm i --save-dev webpack-oss
скопировать код

const AliOssPlugin = require('webpack-oss');

module.exports = {
    configureWebpack: config => {
        if (IS_PROD) {
            const plugins = [];
            // 上传文件到oss
            if (process.env.ACCESS_KEY_ID || process.env.ACCESS_KEY_SECRET || process.env.REGION || process.env.BUCKET || process.env.PREFIX) {
                plugins.push(
                    new AliOssPlugin({
                        accessKeyId: process.env.ACCESS_KEY_ID,
                        accessKeySecret: process.env.ACCESS_KEY_SECRET,
                        region: process.env.REGION,
                        bucket: process.env.BUCKET,
                        prefix: process.env.PREFIX,
                        exclude: /.*\.html$/,
                        deleteAll: false
                    })
                );
            }
            config.plugins = [
                ...config.plugins,
                ...plugins
            ];
        }
    }
}
скопировать код

▲ вернуться к началу

☞ Полная конфигурация

Установить зависимости

npm i --save-dev compression-webpack-plugin babel-plugin-transform-remove-console  glob-all purgecss-webpack-plugin
скопировать код

Другие зависимости (@gfx/zopfli, brotli-webpack-plugin, webpack-oss) можно выбрать и установить в соответствии с требованиями

Конфигурация среды

.env

NODE_ENV = 'development'
VUE_APP_BASE_API = 'https://demo.cn/api'
скопировать код

.env.production

Если ali oss включен, VUE_APP_SRC настраивается как префикс URL-адреса ресурса ali oss, например: 'staven.oss-cn-hangzhou.aliyuncs.com/demo'

NODE_ENV = 'production'

VUE_APP_BASE_API = 'https://demo.com/api'
VUE_APP_SRC = '/'

ACCESS_KEY_ID = ''
ACCESS_KEY_SECRET = ''
REGION = 'oss-cn-hangzhou'
BUCKET = 'staven'
PREFIX = 'demo'
скопировать код

.env.analyz

Если ali oss включен, VUE_APP_SRC настраивается как префикс URL-адреса ресурса ali oss, например: 'staven.oss-cn-hangzhou.aliyuncs.com/demo'

NODE_ENV = 'production'
IS_ANALYZ = 'analyz'

VUE_APP_BASE_API = 'https://demo.com/api'
VUE_APP_SRC = VUE_APP_SRC = '/'

ACCESS_KEY_ID = ''
ACCESS_KEY_SECRET = ''
REGION = 'oss-cn-hangzhou'
BUCKET = 'staven'
PREFIX = 'demo'
скопировать код

package.json

"scripts": {
    "serve": "vue-cli-service serve",
    "build": "vue-cli-service build",
    "analyz": "vue-cli-service build --mode analyz",
    "lint": "vue-cli-service lint"
}
скопировать код

babel.config.js

const plugins = [];
// if(['production', 'prod'].includes(process.env.NODE_ENV)) {
//   plugins.push("transform-remove-console")
// }

module.exports = {
  presets: [["@vue/app",{"useBuiltIns": "entry"}]],
  plugins: plugins
};
скопировать код

vue.config.js

const BundleAnalyzerPlugin = require("webpack-bundle-analyzer")
  .BundleAnalyzerPlugin;
const UglifyJsPlugin = require("uglifyjs-webpack-plugin");
const CompressionWebpackPlugin = require("compression-webpack-plugin");
// const zopfli = require("@gfx/zopfli");
// const BrotliPlugin = require("brotli-webpack-plugin");
const AliOssPlugin = require("webpack-oss");

const path = require("path");
const PurgecssPlugin = require("purgecss-webpack-plugin");
const glob = require("glob-all");

const resolve = dir => path.join(__dirname, dir);
const IS_PROD = ["production", "prod"].includes(process.env.NODE_ENV);
const productionGzipExtensions = /\.(js|css|json|txt|html|ico|svg)(\?.*)?$/i;

module.exports = {
  baseUrl: IS_PROD ? process.env.VUE_APP_SRC || "/" : "./", // 默认'/'，部署应用包时的基本 URL
  outputDir: process.env.outputDir || "dist", // 'dist', 生产环境构建文件的目录
  assetsDir: "", // 相对于outputDir的静态资源(js、css、img、fonts)目录
  lintOnSave: false,
  runtimeCompiler: true, // 是否使用包含运行时编译器的 Vue 构建版本
  productionSourceMap: false, // 生产环境的 source map

  configureWebpack: config => {
    // cdn引用时配置externals
    // config.externals = {
    //     'vue': 'Vue',
    //     'element-ui': 'ELEMENT',
    //     'vue-router': 'VueRouter',
    //     'vuex': 'Vuex',
    //     'axios': 'axios'
    // }

    if (IS_PROD) {
      const plugins = [];

      plugins.push(
        new PurgecssPlugin({
          paths: glob.sync([
            path.join(__dirname, "./src/index.html"),
            path.join(__dirname, "./**/*.vue"),
            path.join(__dirname, "./src/**/*.js")
          ])
        })
      );

      plugins.push(
        new UglifyJsPlugin({
          uglifyOptions: {
            compress: {
              warnings: false,
              drop_console: true,
              drop_debugger: false,
              pure_funcs: ["console.log"] //移除console
            }
          },
          sourceMap: false,
          parallel: true
        })
      );
      plugins.push(
        new CompressionWebpackPlugin({
          filename: "[path].gz[query]",
          algorithm: "gzip",
          test: productionGzipExtensions,
          threshold: 10240,
          minRatio: 0.8
        })
      );

      // 上传文件到oss
      //if (process.env.ACCESS_KEY_ID || process.env.ACCESS_KEY_SECRET || process.env.REGION || process.env.BUCKET || process.env.PREFIX) {
      //    plugins.push(
      //        new AliOssPlugin({
      //            accessKeyId: process.env.ACCESS_KEY_ID,
      //            accessKeySecret: process.env.ACCESS_KEY_SECRET,
      //            region: process.env.REGION,
      //            bucket: process.env.BUCKET,
      //            prefix: process.env.PREFIX,
      //            exclude: /.*\.html$/,
      //            deleteAll: false
      //        })
      //    );
      //}

      // Zopfli压缩，需要响应VC库 https://webpack.js.org/plugins/compression-webpack-plugin/
      // plugins.push(
      //     new CompressionWebpackPlugin({
      //         algorithm(input, compressionOptions, callback) {
      //             return zopfli.gzip(input, compressionOptions, callback);
      //         },
      //         compressionOptions: {
      //             numiterations: 15
      //         },
      //         minRatio: 0.99,
      //         test: productionGzipExtensions
      //     })
      // );
      // plugins.push(
      //     new BrotliPlugin({
      //         test: productionGzipExtensions,
      //         minRatio: 0.99
      //     })
      // );
      config.plugins = [...config.plugins, ...plugins];
    }
  },
  chainWebpack: config => {
    // 修复HMR
    config.resolve.symlinks(true);

    // 修复Lazy loading routes Error： Cyclic dependency  [https://github.com/vuejs/vue-cli/issues/1669]
    config.plugin("html").tap(args => {
      args[0].chunksSortMode = "none";
      return args;
    });

    // 添加别名
    config.resolve.alias
      .set("@", resolve("src"))
      .set("assets", resolve("src/assets"))
      .set("components", resolve("src/components"))
      .set("layout", resolve("src/layout"))
      .set("base", resolve("src/base"))
      .set("static", resolve("src/static"));

    // 打包分析
    if (process.env.IS_ANALYZ) {
      config.plugin("webpack-report").use(BundleAnalyzerPlugin, [
        {
          analyzerMode: "static"
        }
      ]);
    }

    // 多页面配置，为js添加hash
    // config.output.chunkFilename(`js/[name].[chunkhash:8].js`)

    // 修改图片输出路径
    // config.module
    //   .rule('images')
    //   .test(/\.(png|jpe?g|gif|ico)(\?.*)?$/)
    //   .use('url-loader')
    //   .loader('url-loader')
    //   .options({
    //       name: path.join('../assets/', 'img/[name].[ext]')
    //   })
  },
  css: {
    modules: false,
    extract: IS_PROD,
    // 为css后缀添加hash
    // extract: {
    //  filename: 'css/[name].[hash:8].css',
    //  chunkFilename: 'css/[name].[hash:8].css'
    //}，
    sourceMap: false,
    loaderOptions: {
      sass: {
        // 向全局sass样式传入共享的全局变量
        // data: `@import "~assets/scss/variables.scss";$src: "${process.env.VUE_APP_SRC}";`
        data: `$src: "${process.env.VUE_APP_SRC}";`
      }
      // px转换为rem
      // postcss: {
      //   plugins: [
      //     require('postcss-pxtorem')({
      //       rootValue : 1, // 换算的基数
      //       selectorBlackList  : ['weui', 'el'], // 忽略转换正则匹配项
      //       propList   : ['*']
      //     })
      //   ]
      // }
    }
  },
  pluginOptions: {
    // 安装vue-cli-plugin-style-resources-loader插件
    // 添加全局样式global.scss
    // "style-resources-loader": {
    //   preProcessor: "scss",
    //   patterns: [
    //     resolve(__dirname, "./src/scss/scss/variables.scss")
    //   ]
    // }
  },
  parallel: require("os").cpus().length > 1,
  pwa: {},
  devServer: {
    // overlay: {
    //   warnings: true,
    //   errors: true
    // },
    open: IS_PROD,
    host: "0.0.0.0",
    port: 8000,
    https: false,
    hotOnly: false,
    proxy: {
      "/api": {
        target: process.env.VUE_APP_BASE_API || "http://127.0.0.1:8080",
        changeOrigin: true
      }
    }
  }
};
скопировать код