webpack4-用之初體驗，一起敲它十一遍

chenhongdong發表於2018-04-26

Web

眾所周知，webpack進入第4個大版本已經有2個月的時間了，而且webpack團隊升級更新的速度也是非常的驚人

在寫下如下內容的時候webpack已經出到了4.6的版本了，劍指5.0應該是指日可待了，當然這些都是個人的臆想，並不代表任何意見

既然我們已經迎接了webpack4的到來了，那麼就一起來使用一下，即使你沒用過之前的版本，沒關係，我們重新出發，將工作中常用到的配置寫給大家來看

非友情提示：由於webpack使用起來並不能僅看程式碼就方便理解，所以有圖有真相的才是正解，於是乎本文配圖很多，真的是很多

首先，既來之，則安之

安裝webpack

需要先在專案中npm init初始化一下，生成package.json
建議node版本安裝到8.2以上

// webpack4中除了正常安裝webpack之外，需要再單獨安一個webpack-cli

npm i webpack webpack-cli -D
複製程式碼

★ npm i -D 是 npm install --save-dev 的簡寫，是指安裝模組並儲存到 package.json 的 devDependencies中，主要在開發環境中的依賴包

0配置了什麼

webpack4可以支援0配置打包，這裡所說的0配置又是什麼呢？當然在開發者眼中0配置的東西，那根本是無法用的，因為不夠智慧，那麼我們就來看看做到了哪些0配置

在使用webpack進行打包的時候，預設情況下會將src下的入口檔案(index.js)進行打包

// node v8.2版本以後都會有一個npx
// npx會執行bin裡的檔案

npx webpack     // 不設定mode的情況下 打包出來的檔案自動壓縮

npx webpack --mode development  // 設定mode為開發模式，打包後的檔案不被壓縮
複製程式碼

當執行npx webpack命令的時候，webpack會自動查詢專案中src目錄下的index.js檔案，然後進行打包，生成一個dist目錄並存在一個打包好的main.js檔案

這些算是0配置的操作了，名字都是定義好的，不能變，想想也很雞肋

webpack的使用還是在我們的配置方面，下面就進入我們的常規操作環節

webpack是基於Node的

在專案下建立一個webpack.config.js(預設，可修改)檔案來配置webpack

module.exports = {
    entry: '',               // 入口檔案
    output: {},              // 出口檔案
    module: {},              // 處理對應模組
    plugins: [],             // 對應的外掛
    devServer: {},           // 開發伺服器配置
    mode: 'development'      // 模式配置
}
複製程式碼

以上就是webpack的正常配置模組

★ 啟動devServer需要安裝一下webpack-dev-server

npm i webpack-dev-server -D
複製程式碼

按照專案的結構，我們就從0開始去寫一下配置吧

// webpack.config.js

const path = require('path');

module.exports = {
    entry: './src/index.js',    // 入口檔案
    output: {
        filename: 'bundle.js',      // 打包後的檔名稱
        path: path.resolve('dist')  // 打包後的目錄，必須是絕對路徑
    }
}
複製程式碼

上面就可以說是實現了最簡單的webpack配置了，那接下來就打包一下看看

配置執行檔案

工作當中我們打包編譯的時候一般都執行npm run dev這樣的命令，既然是通過npm執行的命令，我們就應該找到package.json裡的執行指令碼去配置一下命令，這裡如下圖所示

npm run build就是我們打包後的檔案，這是生產環境下，上線需要的檔案

npm run dev是我們開發環境下打包的檔案，當然由於devServer幫我們把檔案放到記憶體中了，所以並不會輸出打包後的dist資料夾

通過npm run build之後會生成一個dist目錄資料夾，就和上面打包後的樣子一樣了

多入口檔案

多個入口可以有兩種實現方式進行打包

一種是沒有關係的但是要打包到一起去的，可以寫一個陣列，實現多個檔案打包
另一種就是每一個檔案都單獨打包成一個檔案的
下面就來看看這兩種方式的寫法

let path = require('path');

module.exports = {
    // 1.寫成陣列的方式就可以打出多入口檔案，不過這裡打包後的檔案都合成了一個
    // entry: ['./src/index.js', './src/login.js'],
    // 2.真正實現多入口和多出口需要寫成物件的方式
    entry: {
        index: './src/index.js',
        login: './src/login.js'
    },
    output: {
        // 1. filename: 'bundle.js',
        // 2. [name]就可以將出口檔名和入口檔名一一對應
        filename: '[name].js',      // 打包後會生成index.js和login.js檔案
        path: path.resolve('dist')
    }
}
複製程式碼

這時候執行npm run build後，會生成打包好的兩個js檔案，如圖所示

配置Html模板

檔案都打包好了，但是我們在使用的時候不能在dist目錄下去建立一個html檔案，然後去引用打包後的js吧，這不合理，實際開發中也不會這樣

我們需要實現html打包功能，可以通過一個模板實現打包出引用好路徑的html來

這就需要用到一個常用的外掛了，html-webpack-plugin，用之前我們來安一下它

npm i html-webpack-plugin -D
複製程式碼

因為是個外掛，所以需要在config.js裡引用一下的

let path = require('path');
// 外掛都是一個類，所以我們命名的時候儘量用大寫開頭
let HtmlWebpackPlugin = require('html-webpack-plugin');

module.exports = {
    entry: './src/index.js',
    output: {
        // 新增hash可以防止檔案快取，每次都會生成4位的hash串
        filename: 'bundle.[hash:4].js',   
        path: path.resolve('dist')
    },
    plugins: [
        // 通過new一下這個類來使用外掛
        new HtmlWebpackPlugin({
            // 用哪個html作為模板
            // 在src目錄下建立一個index.html頁面當做模板來用
            template: './src/index.html',
            hash: true, // 會在打包好的bundle.js後面加上hash串
        })
    ]
}
複製程式碼

通過上面的配置後，我們再npm run build打包看一下現在是個什麼樣子了

多頁面開發，怎麼配置多頁面

如果開發的時候不只一個頁面，我們需要配置多頁面，那麼需要怎麼來搞呢？不用擔心，html-webpack-plugin外掛自有辦法，我們來觀望一下

let path = require('path');
let HtmlWebpackPlugin = require('html-webpack-plugin');

module.exports = {
    // 多頁面開發，怎麼配置多頁面
    entry: {
        index: './src/index.js',
        login: './src/login.js'
    },
    // 出口檔案  
    output: {                       
        filename: '[name].js',
        path: path.resolve('dist')
    },
    plugins: [
        new HtmlWebpackPlugin({
            template: './src/index.html',   
            filename: 'index.html',
            chunks: ['index']   // 對應關係,index.js對應的是index.html
        }),
        new HtmlWebpackPlugin({
            template: './src/login.html',
            filename: 'login.html',
            chunks: ['login']   // 對應關係,login.js對應的是login.html
        })
    ]
}
複製程式碼

繼續npm run build看打包後的樣子

上面基本介紹完了html和js的打包配置了，現在我們還缺一個好兄弟css，webpack對css的解析需要用到loader，所以我們先提前安裝好，待會好方便使用

引用CSS檔案

可以在src/index.js裡引入css檔案，到時候直接打包到生產目錄下

需要下載一些解析css樣式的loader

npm i style-loader css-loader -D
// 引入less檔案的話，也需要安裝對應的loader
npm i less less-loader -D
複製程式碼

下面我們來看一下如何配置css檔案的解析

// index.js
import './css/style.css';   // 引入css
import './less/style.less'; // 引入less

console.log('這裡是打包檔案入口-index.js');

// webpack.config.js
module.exports = {
    entry: {
        index: './src/index.js'
    },
    output: {
        filename: 'bundle.js',
        path: path.resolve('dist')
    },
    module: {
        rules: [
            {
                test: /\.css$/,     // 解析css
                use: ['style-loader', 'css-loader'] // 從右向左解析
                /* 
                    也可以這樣寫，這種方式方便寫一些配置引數
                    use: [
                        {loader: 'style-loader'},
                        {loader: 'css-loader'}
                    ]
                */
            }
        ]
    }
}
複製程式碼

此時打包後的css檔案是以行內樣式style的標籤寫進打包後的html頁面中，如果樣式很多的話，我們更希望直接用link的方式引入進去，這時候需要把css拆分出來
extract-text-webpack-plugin外掛相信用過的人都知道它是幹什麼的，它的功效就在於會將打包到js裡的css檔案進行一個拆分

拆分CSS

// @next表示可以支援webpack4版本的外掛
npm i extract-text-webpack-plugin@next -D
複製程式碼

let path = require('path');
let HtmlWebpackPlugin = require('html-webpack-plugin');
// 拆分css樣式的外掛
let ExtractTextWebpackPlugin = require('extract-text-webpack-plugin');

module.exports = {
    entry: './src/index.js',
    output: {
        filaneme: 'bundle.js',
        path: path.resolve('dist')
    },
    module: {
        rules: [
            {
                test: /\.css$/,
                use: ExtractTextWebpackPlugin.extract({
                    // 將css用link的方式引入就不再需要style-loader了
                    use: 'css-loader'       
                })
            }
        ]
    },
    plugins: [
        new HtmlWebpackPlugin({
            template: './src/index.html',
        }),
        // 拆分後會把css檔案放到dist目錄下的css/style.css
        new ExtractTextWebpackPlugin('css/style.css')  
    ]
}
複製程式碼

此時拆分完css後，打包的html頁面就以link的方式去引入css了，這樣很好

當然大家很多都說另外一個外掛也是可以辦到的，那就是mini-css-extract-plugin，是的可以說它是為webpack4而生的，而之所以上來就沒有介紹是因為還不成熟，還有很多bug需要去解決的

不過既然大家都知道它，那就順便也提一下吧

npm i mini-css-extract-plugin -D
複製程式碼

使用起來和上面的外掛是差不多的

let MiniCssExtractPlugin = require('mini-css-extract-plugin');

module.exports = {
    module: {
        rules: [
            {
                test: /\.css$/,
                use: [MiniCssExtractPlugin.loader, 'css-loader']
            }
        ]
    },
    plugins: [
        new MiniCssExtractPlugin({
            filename: 'css/a.css'   // 指定打包後的css
        })
    ]
}
複製程式碼

拆分成多個css

這裡要著重說一下上面兩個外掛的區別了，我個人還是建議用extract-text-webpack-plugin的，畢竟從之前的版本承接下來的，雖然在安包的時候需要@next，但是還是值得信賴的

而且現在的extract-text-webpack-plugin也支援了拆分成多個css，而目前mini-css-extract-plugin還不支援此功能

// 正常寫入的less
let styleLess = new ExtractTextWebpackPlugin('css/style.css');
// reset
let resetCss = new ExtractTextWebpackPlugin('css/reset.css');

module.exports = {
    module: {
        rules: [
            {
                test: /\.css$/,
                use: resetCss.extract({
                    use: 'css-loader'
                })
            },
            {
                test: /\.less$/,
                use: styleLess.extract({
                    use: 'css-loader'
                })
            }
        ]
    },
    plugins: [
        styleLess,
        resetCss
    ]
}
複製程式碼

通過這樣操作後可以打包成兩個不同的css檔案，如下圖

引用圖片

處理圖片方面，也需要loader

npm i file-loader url-loader -D
複製程式碼

如果是在css檔案裡引入的如背景圖之類的圖片，就需要指定一下相對路徑

module.exports = {
    module: {
        rules: [
            {
                test: /\.css$/,
                use: ExtractTextWebpackPlugin.extract({
                    use: 'css-loader',
                    publicPath: '../'
                })
            },
            {
                test: /\.(jpe?g|png|gif)$/,
                use: [
                    {
                        loader: 'url-loader',
                        options: {
                            limit: 8192,    // 小於8k的圖片自動轉成base64格式，並且不會存在實體圖片
                            outputPath: 'images/'   // 圖片打包後存放的目錄
                        }
                    }
                ]
            }
        ]
    }
}
複製程式碼

在css中指定了publicPath路徑這樣就可以根據相對路徑引用到圖片資源了，如下圖所示

頁面img引用圖片

頁面中經常會用到img標籤，img引用的圖片地址也需要一個loader來幫我們處理好

npm i html-withimg-loader -D
複製程式碼

module.exports = {
    module: {
        rules: [
            {
                test: /\.(htm|html)$/,
                use: 'html-withimg-loader'
            }
        ]
    }
}
複製程式碼

這樣再打包後的html檔案下img就可以正常引用圖片路徑了

引用字型圖片和svg圖片

字型圖示和svg圖片都可以通過file-loader來解析

module.exports = {
    module: {
        rules: [
            {
                test: /\.(eot|ttf|woff|svg)$/,
                use: 'file-loader'
            }
        ]
    }
}
複製程式碼

這樣即使樣式中引入了這類格式的圖示或者圖片都沒有問題了，img如果也引用svg格式的話，配合上面寫好的html-withimg-loader就都沒有問題了

新增CSS3字首

通過postcss中的autoprefixer可以實現將CSS3中的一些需要相容寫法的屬性新增響應的字首，這樣省去我們不少的時間

由於也是一個loader載入器，我們也需要先安裝一下

npm i postcss-loader autoprefixer -D
複製程式碼

安裝後，我們還需要像webpack一樣寫一個config的配置檔案，在專案根目錄下建立一個postcss.config.js檔案，配置如下：

module.exports = {
    plugins: [require('autoprefixer')]  // 引用該外掛即可了
}
複製程式碼

然後在webpack裡配置postcss-loader

module.exports = {
    module: {
        rules: [
            {
                test: /\.css$/,
                use: ['style-loader', 'css-loader', 'postcss-loader']
            }
        ]
    }
}
複製程式碼

轉義ES6

在實際開發中，我們在大量的使用著ES6及之後的api去寫程式碼，這樣會提高我們寫程式碼的速度，不過由於低版本瀏覽器的存在，不得不需要轉換成相容的程式碼，於是就有了常用的Babel了

Babel會將ES6的程式碼轉成ES5的程式碼

那麼不再多說，既然要使用它，就先來安一下

npm i babel-core babel-loader babel-preset-env babel-preset-stage-0 -D
複製程式碼

當把這些都安好後，我們就開始配置，由於要相容的程式碼不僅僅包含ES6還有之後的版本和那些僅僅是草案的內容，所以我們可以通過一個.babelrc檔案來配置一下，對這些版本的支援

// .babelrc
{
    "presets": ["env", "stage-0"]   // 從右向左解析
}
複製程式碼

我們再在webpack裡配置一下babel-loader既可以做到程式碼轉成ES5了

module.exports = {
    module: {
        rules: [
            {
                test:/\.js$/,
                use: 'babel-loader',
                include: /src/,          // 只轉化src目錄下的js
                exclude: /node_modules/  // 排除掉node_modules，優化打包速度
            }
        ]
    }
}
複製程式碼

在我們每次npm run build的時候都會在dist目錄下建立很多打好的包，如果積累過多可能也會混亂

所以應該在每次打包之前將dist目錄下的檔案都清空，然後再把打好包的檔案放進去

這裡提供一個clean-webpack-plugin外掛

npm i clean-webpack-plugin -D
複製程式碼

let CleanWebpackPlugin = require('clean-webpack-plugin');

module.exports = {
    plugins: [
        // 打包前先清空
        new CleanWebpackPlugin('dist')  
    ]
}
複製程式碼

啟動靜態伺服器

啟動一個靜態伺服器，預設會自動重新整理，就是說你對html,css,js檔案做了修改並儲存後，瀏覽器會預設重新整理一次展現修改後的效果

正常情況下我們都是在開發環境中開發專案，所以之前配置的指令碼"dev"可以派上用場了，在執行npm run dev命令後，會啟動靜態伺服器，我們訪問localhost:3000埠就可以看到開發的頁面內容了

如果devServer裡open設為true後，會自動開啟瀏覽器

module.exports = {
    devServer: {
        contentBase: './dist',
        host: 'localhost',      // 預設是localhost
        port: 3000,             // 埠
        open: true,             // 自動開啟瀏覽器
        hot: true               // 開啟熱更新
    }
}
複製程式碼

當然在npm run dev命令下，打包的檔案存在於記憶體中，並不會產生在dist目錄下

熱更新和自動重新整理的區別

在配置devServer的時候，如果hot為true，就代表開啟了熱更新

But這並沒那麼簡單，因為熱更新還需要配置一個webpack自帶的外掛並且還要在主要js檔案裡檢查是否有module.hot

下面就讓我們直接看下程式碼是如何實現的

// webpack.config.js
let webpack = require('webpack');

module.exports = {
    plugins: [
        // 熱更新，熱更新不是重新整理
        new webpack.HotModuleReplacementPlugin()
    ],
    devServer: {
        contentBase: './dist',
        hot: true,
        port: 3000
    }
}

// 此時還沒完雖然配置了外掛和開啟了熱更新，但實際上並不會生效

// index.js
let a = 'hello world';
document.body.innerHTML = a;
console.log('這是webpack打包的入口檔案');

// 還需要在主要的js檔案裡寫入下面這段程式碼
if (module.hot) {
    // 實現熱更新
    module.hot.accept();
}
複製程式碼

以上index.js中的內容，如果將變數a的值進行修改儲存後，會在不重新整理頁面的情況下直接修改掉，這樣就實現了熱更新

那麼熱更新從現在看來和自動重新整理瀏覽器的區別也不是太大嘛！自動重新整理也是可以接受的啊

其實不然，熱更新的好處可能在vue或者react中有更大的發揮，其中某一個元件被修改的時候就會針對這個元件進行熱更新了，這裡用到vue或react的同學去實際體驗一下吧

resolve解析

在webpack的配置中，resolve我們常用來配置別名和省略字尾名

module.exports = {
    resolve: {
        // 別名
        alias: {
            $: './src/jquery.js'
        },
        // 省略字尾
        extensions: ['.js', '.json', '.css']
    },
}
複製程式碼

這個配置在webpack中比較簡單，我們也就不再敘述了，下面來看點乾貨

提取公共程式碼

在webpack4之前，提取公共程式碼都是通過一個叫CommonsChunkPlugin的外掛來辦到的。到了4以後，內建了一個一模一樣的功能，而且起了一個好聽的名字叫“優化”

下面我們就來看看如何提取公共程式碼

// 假設a.js和b.js都同時引入了jquery.js和一個寫好的utils.js
// a.js和b.js
import $ from 'jquery';
import {sum} from 'utils';
複製程式碼

那麼他們兩個js中其中公共部分的程式碼就是jquery和utils裡的程式碼了

可以針對第三方外掛和寫好的公共檔案

module.exports = {
    entry: {
        a: './src/a.js',
        b: './src/b.js'
    },
    output: {
        filename: '[name].js',
        path: path.resolve('dust')
    },
    // 提取公共程式碼
+   optimization: {
        splitChunks: {
            cacheGroups: {
                vendor: {   // 抽離第三方外掛
                    test: /node_modules/,   // 指定是node_modules下的第三方包
                    chunks: 'initial',
                    name: 'vendor',  // 打包後的檔名，任意命名    
                    // 設定優先順序，防止和自定義的公共程式碼提取時被覆蓋，不進行打包
                    priority: 10    
                },
                utils: { // 抽離自己寫的公共程式碼，utils這個名字可以隨意起
                    chunks: 'initial',
                    name: 'utils',  // 任意命名
                    minSize: 0    // 只要超出0位元組就生成一個新包
                }
            }
        }
+   },
    plugins: [
        new HtmlWebpackPlugin({
            filename: 'a.html',
            template: './src/index.html',  // 以index.html為模板
+           chunks: ['vendor', 'a']
        }),
        new HtmlWebpackPlugin({
            filename: 'b.html',
            template: './src/index.html',  // 以index.html為模板
+           chunks: ['vendor', 'b']
        })
    ]
}
複製程式碼

通過以上配置，可以把引入到a.js和b.js中的這部分公共程式碼提取出來，如下圖所示

指定webpack配置檔案

在package.json的腳步裡，我們可以配置呼叫不同的webpack配置檔案進行打包，舉個例子

這樣的好處在於可以針對不同的需求進行一個特定的打包配置

就到這裡吧

關於webpack4的一些常規操作就說到這裡了，其實在工作當中更多時候，也並不需要我們去配置這些內容

不過我們要爭做優秀的前端兒，所以就必須掌握這些必備的技能，必須會，沒有之一！

好了，就寫到這裡吧，想必大家也看累了吧，辛苦大家了，哈哈。

MQTT之初體驗
2019-03-07
MQQT
Chrome之初體驗
2011-11-22
Chrome
設計模式之初體驗
2020-11-17
設計模式
MySQL複製之初體驗
2014-07-18
MySql
Android DataBinding之初體驗
2019-02-21
Android
Python爬蟲之初體驗
2017-12-13
Python爬蟲
ASP.NET MVC之初體驗
2008-09-12
ASP.NETMVC
Laravel-S 專案之初體驗
2019-11-05
Laravel
小程式雲開發之初體驗
2019-03-26
Django基礎教程之初體驗
2021-04-04
Django
NodeJs之初體驗04—UR(X)
2019-01-23
NodeJS
ruby on rails腳手架之初體驗
2017-03-11
AI
物化檢視應用之初體驗~~~
2007-05-11
它來了，它來了，HarmonyOS應用開發線上體驗來了
2021-04-16
重新敲一遍程式碼，勝過拷貝貼上
2015-12-08
hexo+github搭建靜態部落格之初體驗
2018-07-23
HexoGithub
Android百度地圖開發（一）之初體驗
2015-01-11
Android地圖
webpack4-基礎配置
2019-02-14
Web
substrate學習筆記8：ink合約開發之初體驗
2022-03-30
筆記
使用者故事地圖(User Story Mapping)之初體驗
2016-01-11
地圖APP
來啊~一起敲一個chrome擴充套件
2019-04-22
Chrome套件
NDK 知識梳理(1) 使用 CMake 進行 NDK 開發之初體驗
2017-12-13
帶你一起擼一遍 nodejs 常用核心模組（三）
2019-02-27
NodeJS
帶你一起擼一遍 nodejs 常用核心模組（二）
2019-03-03
NodeJS
帶你一起擼一遍 nodejs 常用核心模組（一）
2018-07-08
NodeJS
【實驗】【MySQL】MySQL 5.0 windows版本之初探
2009-04-03
MySqlWindows
Python 程式設計師的 Golang 學習指南 (I): Go 之初體驗
2016-10-12
Python程式設計師Golang
Python 程式設計師的 Golang 學習指南（I）: Go 之初體驗
2016-10-12
Python程式設計師Golang
一起來驗證！換IP軟體真的有用嘛?
2018-11-14
1.設計模式之初體驗—精讀《JavaScript 設計模式》Addy Osmani著
2018-11-10
設計模式JavaScript
十大惡劣的網站體驗
2012-10-10
網站
HiveQL應用體驗
2013-05-12
Hive
快應用初體驗
2018-03-22
聲網一起 KTV 功能初體驗 | 掘金技術徵文
2019-05-04
十年架構五年生活-01畢業之初
2022-07-18
架構
為何雲遊戲很重要，它將創造怎樣的體驗？
2020-08-19
遊戲
學好這十招讓你充分體驗 Windows 10
2015-06-24
Windows
淺談元遊戲：“遊戲知道你在玩它”是種什麼體驗？
2020-05-18
遊戲