Vue.js CLI4 Vue.config.js標(biāo)準(zhǔn)配置 (最全注釋)

前言:

Vue.js CLI工具 不知不覺發(fā)展到了4.0時(shí)代,CLI給人最直白的感受是沒有了build文件夾跟config文件夾,所有的配置都在Vue.config.js完成。那么該文件的配置至關(guān)重要。現(xiàn)在我們來看一下最新配置是怎么配置的。

有三種方式,推薦第二種標(biāo)準(zhǔn)版(無需安裝依賴,直接復(fù)制即可配置)。
1、依賴庫

npm install vue-cli-configjs



2、標(biāo)準(zhǔn)版

// vue.config.js
const path =  require('path');
const IS_PROD = ['production', 'prod'].includes(process.env.NODE_ENV);
const resolve = (dir) => path.join(__dirname, dir);
module.exports = {
    publicPath: process.env.NODE_ENV === 'production' ? '/site/vue-demo/' : '/',  // 公共路徑
    indexPath: 'index.html' , // 相對于打包路徑index.html的路徑
    outputDir: process.env.outputDir || 'dist', // 'dist', 生產(chǎn)環(huán)境構(gòu)建文件的目錄
    assetsDir: 'static', // 相對于outputDir的靜態(tài)資源(js、css、img、fonts)目錄
    lintOnSave: false, // 是否在開發(fā)環(huán)境下通過 eslint-loader 在每次保存時(shí) lint 代碼
    runtimeCompiler: true, // 是否使用包含運(yùn)行時(shí)編譯器的 Vue 構(gòu)建版本
    productionSourceMap: !IS_PROD, // 生產(chǎn)環(huán)境的 source map
    parallel: require("os").cpus().length > 1, // 是否為 Babel 或 TypeScript 使用 thread-loader。該選項(xiàng)在系統(tǒng)的 CPU 有多于一個內(nèi)核時(shí)自動啟用,僅作用于生產(chǎn)構(gòu)建。
    pwa: {}, // 向 PWA 插件傳遞選項(xiàng)。
    chainWebpack: config => {
        config.resolve.symlinks(true); // 修復(fù)熱更新失效
        // 如果使用多頁面打包,使用vue inspect --plugins查看html是否在結(jié)果數(shù)組中
        config.plugin("html").tap(args => {
            // 修復(fù) Lazy loading routes Error
            args[0].chunksSortMode = "none";
            return args;
        });
        config.resolve.alias // 添加別名
            .set('@', resolve('src'))
            .set('@assets', resolve('src/assets'))
            .set('@components', resolve('src/components'))
            .set('@views', resolve('src/views'))
            .set('@store', resolve('src/store'));
    },
    css: {
        extract: IS_PROD,
        requireModuleExtension: false,// 去掉文件名中的 .module
        loaderOptions: {
                // 給 less-loader 傳遞 Less.js 相關(guān)選項(xiàng)
                less: {
                    // `globalVars` 定義全局對象,可加入全局變量
                    globalVars: {
                        primary: '#333'
                    }
                }
        }
    },
    devServer: {
            overlay: { // 讓瀏覽器 overlay 同時(shí)顯示警告和錯誤
              warnings: true,
              errors: true
            },
            host: "localhost",
            port: 8080, // 端口號
            https: false, // https:{type:Boolean}
            open: false, //配置自動啟動瀏覽器
            hotOnly: true, // 熱更新
            // proxy: 'http://localhost:8080'   // 配置跨域處理,只有一個代理
            proxy: { //配置多個跨域
                "/api": {
                    target: "http://172.11.11.11:7071",
                    changeOrigin: true,
                    // ws: true,//websocket支持
                    secure: false,
                    pathRewrite: {
                        "^/api": "/"
                    }
                },
                "/api2": {
                    target: "http://172.12.12.12:2018",
                    changeOrigin: true,
                    //ws: true,//websocket支持
                    secure: false,
                    pathRewrite: {
                        "^/api2": "/"
                    }
                },
            }
        }
}



3、升級版

// vue.config.js
const path =  require('path');

const CompressionWebpackPlugin = require("compression-webpack-plugin"); // 開啟gzip壓縮, 按需引用
const productionGzipExtensions = /\.(js|css|json|txt|html|ico|svg)(\?.*)?$/i; // 開啟gzip壓縮, 按需寫入
const BundleAnalyzerPlugin = require("webpack-bundle-analyzer").BundleAnalyzerPlugin; // 打包分析

const IS_PROD = ['production', 'prod'].includes(process.env.NODE_ENV);
const resolve = (dir) => path.join(__dirname, dir);
module.exports = {
    publicPath: process.env.NODE_ENV === 'production' ? '/site/vue-demo/' : '/',  // 公共路徑
    indexPath: 'index.html' , // 相對于打包路徑index.html的路徑
    outputDir: process.env.outputDir || 'dist', // 'dist', 生產(chǎn)環(huán)境構(gòu)建文件的目錄
    assetsDir: 'static', // 相對于outputDir的靜態(tài)資源(js、css、img、fonts)目錄
    lintOnSave: false, // 是否在開發(fā)環(huán)境下通過 eslint-loader 在每次保存時(shí) lint 代碼
    runtimeCompiler: true, // 是否使用包含運(yùn)行時(shí)編譯器的 Vue 構(gòu)建版本
    productionSourceMap: !IS_PROD, // 生產(chǎn)環(huán)境的 source map
    parallel: require("os").cpus().length > 1, // 是否為 Babel 或 TypeScript 使用 thread-loader。該選項(xiàng)在系統(tǒng)的 CPU 有多于一個內(nèi)核時(shí)自動啟用,僅作用于生產(chǎn)構(gòu)建。
    pwa: {}, // 向 PWA 插件傳遞選項(xiàng)。
    chainWebpack: config => {
        config.resolve.symlinks(true); // 修復(fù)熱更新失效
        // 如果使用多頁面打包,使用vue inspect --plugins查看html是否在結(jié)果數(shù)組中
        config.plugin("html").tap(args => {
            // 修復(fù) Lazy loading routes Error
            args[0].chunksSortMode = "none";
            return args;
        });
        config.resolve.alias // 添加別名
            .set('@', resolve('src'))
            .set('@assets', resolve('src/assets'))
            .set('@components', resolve('src/components'))
            .set('@views', resolve('src/views'))
            .set('@store', resolve('src/store'));
        // 壓縮圖片
        // 需要 npm i -D image-webpack-loader
        config.module
            .rule("images")
            .use("image-webpack-loader")
            .loader("image-webpack-loader")
            .options({
                mozjpeg: { progressive: true, quality: 65 },
                optipng: { enabled: false },
                pngquant: { quality: [0.65, 0.9], speed: 4 },
                gifsicle: { interlaced: false },
                webp: { quality: 75 }
            });
        // 打包分析
        // 打包之后自動生成一個名叫report.html文件(可忽視)
        if (IS_PROD) {
            config.plugin("webpack-report").use(BundleAnalyzerPlugin, [
                {
                    analyzerMode: "static"
                }
            ]);
        }
    },
    configureWebpack: config => {
        // 開啟 gzip 壓縮
        // 需要 npm i -D compression-webpack-plugin
        const plugins = [];
        if (IS_PROD) {
            plugins.push(
                new CompressionWebpackPlugin({
                    filename: "[path].gz[query]",
                    algorithm: "gzip",
                    test: productionGzipExtensions,
                    threshold: 10240,
                    minRatio: 0.8
                })
            );
        }
        config.plugins = [...config.plugins, ...plugins];
    },
    css: {
        extract: IS_PROD,
        requireModuleExtension: false,// 去掉文件名中的 .module
        loaderOptions: {
                // 給 less-loader 傳遞 Less.js 相關(guān)選項(xiàng)
                less: {
                    // `globalVars` 定義全局對象,可加入全局變量
                    globalVars: {
                        primary: '#333'
                    }
                }
        }
    },
    devServer: {
            overlay: { // 讓瀏覽器 overlay 同時(shí)顯示警告和錯誤
              warnings: true,
              errors: true
            },
            host: "localhost",
            port: 8080, // 端口號
            https: false, // https:{type:Boolean}
            open: false, //配置自動啟動瀏覽器
            hotOnly: true, // 熱更新
            // proxy: 'http://localhost:8080'   // 配置跨域處理,只有一個代理
            proxy: { //配置多個跨域
                "/api": {
                    target: "http://172.11.11.11:7071",
                    changeOrigin: true,
                    // ws: true,//websocket支持
                    secure: false,
                    pathRewrite: {
                        "^/api": "/"
                    }
                },
                "/api2": {
                    target: "http://172.12.12.12:2018",
                    changeOrigin: true,
                    //ws: true,//websocket支持
                    secure: false,
                    pathRewrite: {
                        "^/api2": "/"
                    }
                },
            }
        }
}



結(jié)語

上述代碼可以直接復(fù)制,也可以按需引入,一般都用的到,注意里面需要安裝的依賴。
注意第三種方式:可能在安裝以下依賴時(shí),會報(bào)錯,建議按以下順序安裝。

npm install --save-dev  compression-webpack-plugin



npm install --save-dev  image-webpack-loader





作者:Vam的金豆之路

主要領(lǐng)域:前端開發(fā)

我的微信:maomin9761

微信公眾號:前端歷劫之路