webpack 已是現代 Web 開發中最關鍵的工具之一。它本質上是 JavaScript 的模組打包器,但同樣能處理其他前端資源,例如 HTML、CSS 甚至圖片。它能讓你更精準地掌控應用發出的 HTTP 請求數量,也能讓你使用 Jade、Sass、ES6 等各類資源的特性,甚至直接從 npm 下載套件來用。
本文鎖定剛接觸 webpack 的讀者,會依序說明初始設定、模組、loader、plugin、程式碼分割與熱模組替換。開始之前,請先確認你的電腦已安裝 Node.js。
初始設定
用 npm 初始化專案並安裝 webpack:
mkdir webpack-demo cd webpack-demo npm init -y npm install webpack@beta --save-dev mkdir src touch index.html src/app.js webpack.config.js
接著建立以下幾個檔案:
<!-- index.html --> <!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"> <title>Hello webpack</title> </head> <body> <div id="root"></div> <script src="dist/bundle.js"></script> </body> </html>
// src/app.js const root = document.querySelector('#root') root.innerHTML = `<p>Hello webpack.</p>`
// webpack.config.js const webpack = require('webpack') const path = require('path') const config = { context: path.resolve(__dirname, 'src'), entry: './app.js', output: { path: path.resolve(__dirname, 'dist'), filename: 'bundle.js' }, module: { rules: [{ test: /\.js$/, include: path.resolve(__dirname, 'src'), use: [{ loader: 'babel-loader', options: { presets: [ ['es2015', { modules: false }] ] } }] }] } } module.exports = config
這份設定是個標準起點:它告訴 webpack 把入口檔 src/app.js 編譯輸出到 /dist/bundle.js,並用 babel 把所有 .js 從 ES2015 轉譯成 ES5。
要完成轉譯,需要安裝三個套件:babel-core、loader babel-loader 以及預設集 babel-preset-es2015。其中 { modules: false } 的作用是讓 Tree Shaking 生效,把未使用的匯出項目從打包結果中移除,藉此縮小檔案體積。
npm install babel-core babel-loader babel-preset-es2015 --save-dev
最後,把 package.json 的 scripts 區塊替換成:
"scripts": { "start": "webpack --watch", "build": "webpack -p" },
在命令列執行 npm start 會以監視模式啟動 webpack,src 目錄下的 .js 一旦變動就會重新編譯 bundle.js。終端機的輸出會顯示打包檔案的資訊,其中檔案數量與大小特別值得留意。

現在在瀏覽器開啟 index.html,就會看到 "Hello webpack."。
open index.html
打開 dist/bundle.js 看看 webpack 做了什麼:頂部是 webpack 的模組引導程式碼,底部則是我們自己寫的模組。到目前為止可能還不太有感覺,但接下來你就可以開始寫 ES6 模組,而 webpack 會產出兼容各種瀏覽器的打包檔。
用 Ctrl + C 停止 webpack,再執行 npm run build 以正式模式編譯 bundle.js。
你會注意到打包檔從 2.61 kB 縮小到 585 位元組。再看一次 dist/bundle.js,裡頭是一大段難以閱讀的程式碼,因為我們用 UglifyJS 做了壓縮——用更少的程式碼達到相同效果。
模組
webpack 能識別多種 JavaScript 模組格式,最常見的兩種是:
我們可以透過安裝並匯入 lodash 來實際驗證。
npm install lodash --save
// src/app.js import {groupBy} from 'lodash/collection' const people = [{ manager: 'Jen', name: 'Bob' }, { manager: 'Jen', name: 'Sue' }, { manager: 'Bob', name: 'Shirley' }, { manager: 'Bob', name: 'Terrence' }] const managerGroups = groupBy(people, 'manager') const root = document.querySelector('#root') root.innerHTML = `<pre>${JSON.stringify(managerGroups, null, 2)}</pre>`
執行 npm start 啟動 webpack 並重新整理 index.html,就能看到依 manager 分組後的結果。
接著把這份資料抽到獨立模組 people.js 裡。
// src/people.js const people = [{ manager: 'Jen', name: 'Bob' }, { manager: 'Jen', name: 'Sue' }, { manager: 'Bob', name: 'Shirley' }, { manager: 'Bob', name: 'Terrence' }] export default people
在 app.js 中用相對路徑就能輕鬆匯入。
// src/app.js import {groupBy} from 'lodash/collection' import people from './people' const managerGroups = groupBy(people, 'manager') const root = document.querySelector('#root') root.innerHTML = `<pre>${JSON.stringify(managerGroups, null, 2)}</pre>`
注意:像 lodash/collection 這種沒有相對路徑的匯入,指的是 /node_modules 中已安裝的套件;自己的模組則需要 ./people 這類相對路徑,這也是兩者的直觀區別。
Loader
前面提過,可以透過設定像 babel-loader 這樣的 loader,告訴 webpack 遇到不同型別的檔案時該怎麼處理。多個 loader 也能串接起來,完成更複雜的轉換。在 JS 中直接匯入 .sass 就是一個很好的例子。
Sass
這項轉換需要三個 loader 搭配 node-sass:
npm install css-loader style-loader sass-loader node-sass --save-dev
在設定檔中為 .scss 新增一條規則。
// webpack.config.js rules: [{ test: /\.scss$/, use: [ 'style-loader', 'css-loader', 'sass-loader' ] }, { // ... }]
注意:只要修改 webpack.config.js 中的 loader 規則,就得用 Ctrl + C 停止後再執行 npm start 重新啟動。
loader 的執行順序與宣告順序相反:
以上就是本次整理的內容,希望對你的學習有所幫助。