1. 程式人生 > >基於Vue cli生成的Vue專案的webpack4升級

基於Vue cli生成的Vue專案的webpack4升級

前面的話

  本文將詳細介紹從webpack3到webpack4的升級過程

概述

  相比於webpack3,webpack4可以零配置執行,打包速度比之前提高了90%,可以直接到ES6的程式碼進行無用程式碼剔除,新增的optimization使用簡單

  在未來,CSS、HTMl和檔案都會成為原生模組

【0配置】

  webpack4 設定了預設值,以便無配置啟動專案

entry 預設值是 ./src/
output.path 預設值是 ./dist
mode 預設值是 production

【模組型別】

  webpack4提供了5種模組型別

json: 可通過 require 和 import 匯入的 JSON 格式的資料(預設為 .json 的檔案)
webassembly: WebAssembly 模組,(目前是 .wasm 檔案的預設型別)
javascript/auto: (webpack 3中的預設型別)支援所有的JS模組系統:CommonJS、AMD。
javascript/esm: EcmaScript模組(預設 .mjs 檔案)。
javascript/dynamic: 僅支援 CommonJS & AMD。
  webpack 4 不僅支援本地處理 JSON,還支援對 JSON 的 Tree Shaking。當使用 ESM 語法 import json 時,webpack 會消除掉JSON Module 中未使用的匯出。此外,如果要用 loader 轉換 json 為 js,需要設定 type 為 javascript/auto

模式mode

  相比於webpack3,webpack4新增了一個mode配置選擇,用來表示配置模式的選擇情況

module.exports = {
  mode: 'production'
}

  包括生產環境production、開發環境devolopment和自定義none這三個選擇可選

【開發模式】

瀏覽器除錯工具
註釋、開發階段的詳細錯誤日誌和提示
快速和優化的增量構建機制
開啟 output.pathinfo 在 bundle 中顯示模組資訊
開啟 NamedModulesPlugin
開啟 NoEmitOnErrorsPlugin

【生產模式】

啟用所有優化程式碼的功能
更小的bundle大小
去除只在開發階段執行的程式碼
關閉記憶體快取
Scope hoisting 和 Tree-shaking
開啟 NoEmitOnErrorsPlugin
開啟 ModuleConcatenationPlugin
開啟 optimization.minimize

【none】

  禁用所有的預設設定

optimization

  從webpack4開始官方移除了commonchunk外掛,改用了optimization屬性進行更加靈活的配置,下面來介紹optimization下的一些常用配置項

【minimize】

  利用unglifyjsWebpackPlugin外掛來壓縮模組,生產環境下該值預設為true

  optimization: {
    minimize: false
  }

【minimier】

  可以使用其他外掛來執行壓縮功能

const UglifyJsPlugin = require('uglifyjs-webpack-plugin');

module.exports = {
  //...
  optimization: {
    minimizer: [
      new UglifyJsPlugin({ /* your config */ })
    ]
  }
};

【splitChunks】

  webpack4預設使用splitChunksPlugin外掛來實現程式碼分割功能,來替代webpack3中的commonChunksPlugin外掛

module.exports = {
  //...
  optimization: {
    splitChunks: {
      chunks: 'async',
      minSize: 30000,
      minChunks: 1,
      maxAsyncRequests: 5,
      maxInitialRequests: 3,
      automaticNameDelimiter: '~',
      name: true,
      cacheGroups: {
        vendors: {
          test: /[\\/]node_modules[\\/]/,
          priority: -10
        },
        default: {
          minChunks: 2,
          priority: -20,
          reuseExistingChunk: true
        }
      }
    }
  }

【runtimeChunk】

  通過設定 runtimeChunk: true 來為每一個入口預設新增一個只包含 runtime 的 chunk

  通過提供字串值,可以使用外掛的預設模式

signal: 建立一個被所有生成的塊共享的runtime檔案
multiple: 為共同的塊建立多個runtime檔案

  預設值為false,表示每個入口塊預設內嵌runtime程式碼

    runtimeChunk {
      name: "runtime"
    }

【noEmitOnErrors】

  只要在編譯時出現錯誤,就使用noEmitOnErrors屬性來跳過emit 階段,用來替代NoEmitOnErrorsPlugin 外掛

【nameModules】

  使用可讀的模組標識,方便更好的除錯。webpack在開發模式下預設開啟,生產模式下預設關閉,用來替代 NamedModulesPlugin 外掛

module.exports = {
  //...
  optimization: {
    namedModules: true
  }
};

升級

  下面就基於vue-cli的專案對webpack配置進行升級

  1、升級nodejs

  使用 webpack4 時,必須保證 Node.js 版本 >= 8.9.4,因為 webpack4 使用了大量的ES6語法,這些語法在 nodejs新版 v8 中得到了原生支援

  2、升級webpack主要部件,包括webpack、webpack-bundle-analyzer、webpack-dev-server、webpack-merge

  升級的操作很簡單,先刪除,再安裝即可。但要注意的是webpack4版本中 cli 工具分離成了 webpack 核心庫 與 webpack-cli 命令列工具兩個模組,需要使用 CLI,必安裝 webpack-cli 至專案中

cnpm uninstall -D webpack webpack-bundle-analyzer webpack-dev-server webpack-merge
cnpm install -D webpack webpack-cli webpack-bundle-analyzer webpack-dev-server webpack-merge

  3、升級webpack相關外掛,包括copy-webpack-plugin、css-loader、eslint-loader、file-loader、html-webpack-plugin、url-loader、friendly-errors-webpack-plugin、optimize-css-assets-webpack-plugin、uglifyjs-webpack-plugin

cnpm uninstall -D copy-webpack-plugin css-loader eslint-loader file-loader html-webpack-plugin url-loader  friendly-errors-webpack-plugin optimize-css-assets-webpack-plugin uglifyjs-webpack-plugin
cnpm install -D copy-webpack-plugin css-loader eslint-loader file-loader html-webpack-plugin url-loader  friendly-errors-webpack-plugin optimize-css-assets-webpack-plugin uglifyjs-webpack-plugin

  4、升級vue-loader

  由於vue-loader升級到版本15後,配置有較多的變化,穩妥起見,可以只將vue-loader升級到14.4.2

cnpm uninstall -D vue-loader
cnpm uninstall -D [email protected]14.4.2

  5、替換webpack相關外掛,extract-text-webpack-plugin替換為mini-css-extract-plugin

cnpm uninstall -D extract-text-webpack-plugin
cnpm install -D mini-css-extract-plugin

配置

  下面對配置檔案的修改進行詳細說明:

  1、webpack.base.conf.js檔案

  增加node:process.env.NODE_ENV即可

module.exports = {
+  mode: process.env.NODE_ENV,
...

  2、webpack.prop.conf.js檔案

  該檔案的配置項較為複雜

  (1)將ExtractTextPlugin替換為MiniCssExtraPlugin

+ const MiniCssExtractPlugin = require("mini-css-extract-plugin")
- const ExtractTextPlugin = require('extract-text-webpack-plugin')

...
-    new ExtractTextPlugin({
+    new MiniCssExtractPlugin({
      filename: utils.assetsPath('css/[name].[contenthash].css'),
      allChunks: true,
    }),
...

  (2)刪除UglifyJsPlugin配置項

- const UglifyJsPlugin = require('uglifyjs-webpack-plugin')
...
- new UglifyJsPlugin({
-      uglifyOptions: {
-        compress: {
-          warnings: false
-        }
-      },
-      sourceMap: config.build.productionSourceMap,
-      parallel: true
- })

  (3)刪除CommonsChunkPlugin配置項

- new webpack.optimize.CommonsChunkPlugin({
-      name: 'vendor',
-      minChunks (module) {
-        return (
-          module.resource &&
-          /\.js$/.test(module.resource) &&
-          module.resource.indexOf(
-            path.join(__dirname, '../node_modules')
-          ) === 0
-        )
-      }
-    }),
-    new webpack.optimize.CommonsChunkPlugin({
-     name: 'manifest',
-      minChunks: Infinity
-    }),
-    new webpack.optimize.CommonsChunkPlugin({
-      name: 'app',
-      async: 'vendor-async',
-      children: true,
-      minChunks: 3
-    }), 
...

  (4)新增optimization配置項

+  optimization: {
+    splitChunks: {
+      chunks: 'async',
+      minSize: 30000,
+      minChunks: 1,
+      maxAsyncRequests: 5,
+      maxInitialRequests: 3,
+      automaticNameDelimiter: '~',
+      name: true,
+      cacheGroups: {
+        vendors: {
+          test: /[\\/]node_modules[\\/]/,
+          priority: -10
+        },
+        default: {
+          minChunks: 2,
+          priority: -20,
+          reuseExistingChunk: true
+        }
+      }
+    },
+    runtimeChunk: { name: 'runtime' }
+  },