基於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' } + },