1. 程式人生 > >Webpack 入門教程

Webpack 入門教程

bpa 自動刷新 less works head 靜態分析 索引 www html

Webpack 是一個前端資源加載/打包工具。它將根據模塊的依賴關系進行靜態分析,然後將這些模塊按照指定的規則生成對應的靜態資源。

本章節基於 Webpack3.0 測試通過。

技術分享

從圖中我們可以看出,Webpack 可以將多種靜態資源 js、css、less 轉換成一個靜態文件,減少了頁面的請求。

接下來我們簡單為大家介紹 Webpack 的安裝與使用。

安裝 Webpack

在安裝 Webpack 前,你本地環境需要支持 node.js。

由於 npm 安裝速度慢,本教程使用了淘寶的鏡像及其命令 cnpm,安裝使用介紹參照:使用淘寶 NPM 鏡像。

使用 cnpm 安裝 webpack:

cnpm install webpack -g

創建項目

接下來我們創建一個目錄 app:

mkdir app

在 app 目錄下添加 study1.js 文件,代碼如下:

app/study1.js 文件

1 document.write("It works.");

在 app 目錄下添加 index.html 文件,代碼如下:

app/index.html 文件

1 <html>
2     <head>
3         <meta charset="utf-8">
4     </head>
5     <body>
6 <script type="text/javascript" src="bundle.js" charset="utf-8"></script> 7 </body> 8 </html>

接下來我們使用 webpack 命令來打包:

webpack study1.js bundle.js

執行以上命令會編譯study1.js 文件並生成bundle.js 文件,成功後輸出信息如下所示:

Hash: a41c6217554e666594cb
Version: webpack 1.12.13
Time:
50ms Asset Size Chunks Chunk Names bundle.js 1.42 kB 0 [emitted] main [0] ./study1.js 29 bytes {0} [built]
 

在瀏覽器中打開 index.html,輸出結果如下:

技術分享

創建第二個 JS 文件

接下來我們創建另外一個 js 文件 study2.js,代碼如下所示:

app/study2.js 文件

1 module.exports = "It works from study2.js.";

更新 study1.js 文件,代碼如下:

app/study1.js 文件

1 document.write(require("./study2.js"));

接下來我們使用 webpack 命令來打包:

webpack study1.js bundle.js
 
Hash: dcf55acff639ebfe1677
Version: webpack 1.12.13
Time: 52ms
    Asset     Size  Chunks             Chunk Names
bundle.js  1.55 kB       0  [emitted]  main
   [0] ./study1.js 41 bytes {0} [built]
   [1] ./study2.js 46 bytes {0} [built]

在瀏覽器訪問,輸出結果如下所示:

技術分享

webpack 根據模塊的依賴關系進行靜態分析,這些文件(模塊)會被包含到 bundle.js 文件中。Webpack 會給每個模塊分配一個唯一的 id 並通過這個 id 索引和訪問模塊。 在頁面啟動時,會先執行 study1.js 中的代碼,其它模塊會在運行 require 的時候再執行。


LOADER

Webpack 本身只能處理 JavaScript 模塊,如果要處理其他類型的文件,就需要使用 loader 進行轉換。

所以如果我們需要在應用中添加 css 文件,就需要使用到 css-loader 和 style-loader,他們做兩件不同的事情,css-loader 會遍歷 CSS 文件,然後找到 url() 表達式然後處理他們,style-loader 會把原來的 CSS 代碼插入頁面中的一個 style 標簽中。

接下來我們使用以下命令來安裝 css-loader 和 style-loader(全局安裝需要參數 -g)。

cnpm install css-loader style-loader

執行以上命令後,會再當前目錄生成 node_modules 目錄,它就是 css-loader 和 style-loader 的安裝目錄。

接下來創建一個 style.css 文件,代碼如下:

app/style.css 文件

1 body { background: yellow; }

修改 study1.js 文件,代碼如下:

app/study1.js 文件

1 require("!style-loader!css-loader!./style.css");
2 document.write(require("./study2.js"));

接下來我們使用 webpack 命令來打包:

webpack study1.js bundle.js
 
Hash: a9ef45165f81c89a4363
Version: webpack 1.12.13
Time: 619ms
    Asset     Size  Chunks             Chunk Names
bundle.js  11.8 kB       0  [emitted]  main
   [0] ./study1.js 76 bytes {0} [built]
   [5] ./study2.js 46 bytes {0} [built]
    + 4 hidden modules

在瀏覽器訪問,輸出結果如下所示:

技術分享

require CSS 文件的時候都要寫 loader 前綴 !style-loader!css-loader!,當然我們可以根據模塊類型(擴展名)來自動綁定需要的 loader。 將 study1.js 中的 require("!style-loader!css-loader!./style.css") 修改為 require("./style.css")

app/study1.js 文件

1 require("./style.css"); document.write(require("./study2.js"));

然後執行:

webpack study1.js bundle.js --module-bind ‘css=style-loader!css-loader‘

在瀏覽器訪問,輸出結果如下所示:

技術分享

顯然,這兩種使用 loader 的方式,效果是一樣的。


配置文件

我們可以將一些編譯選項放在配置文件中,以便於統一管理:

創建 webpack.config.js 文件,代碼如下所示:

app/webpack.config.js 文件

 1 module.exports = {
 2     entry: "./study1.js",
 3     output: {
 4         path: __dirname,
 5         filename: "bundle.js"
 6     },
 7     module: {
 8         loaders: [
 9             { test: /\.css$/, loader: "style-loader!css-loader" }
10         ]
11     }
12 };

接下來我們只需要執行 webpack 命令即可生成 bundle.js 文件:

webpack
 
Hash: 4fdefac099a5f36ff74b
Version: webpack 1.12.13
Time: 576ms
    Asset     Size  Chunks             Chunk Names
bundle.js  11.8 kB       0  [emitted]  main
   [0] ./study1.js 65 bytes {0} [built]
   [5] ./study2.js 46 bytes {0} [built]
    + 4 hidden modules

webpack 命令執行後,會默認載入當前目錄的 webpack.config.js 文件。


插件

插件在 webpack 的配置信息 plugins 選項中指定,用於完成一些 loader 不能完成的工。

webpack 自帶一些插件,你可以可以通過 cnpm 安裝一些插件。

使用內置插件需要通過以下命令來安裝:

cnpm install webpack --save-dev

比如我們可以安裝內置的 BannerPlugin 插件,用於在文件頭部輸出一些註釋信息。

修改 webpack.config.js,代碼如下:

app/webpack.config.js 文件

 1 var webpack=require(‘webpack‘);
 2  
 3 module.exports = {
 4     entry: "./study1.js",
 5     output: {
 6         path: __dirname,
 7         filename: "bundle.js"
 8     },
 9     module: {
10         loaders: [
11             { test: /\.css$/, loader: "style-loader!css-loader" }
12         ]
13     },
14     plugins:[
15     new webpack.BannerPlugin(‘入門教程 webpack 實例‘)
16     ]
17 };

然後運行:

webpack

打開 bundle.js,可以看到文件頭部出現了我們指定的註釋信息。


開發環境

當項目逐漸變大,webpack 的編譯時間會變長,可以通過參數讓編譯的輸出內容帶有進度和顏色。

webpack --progress --colors

如果不想每次修改模塊後都重新編譯,那麽可以啟動監聽模式。開啟監聽模式後,沒有變化的模塊會在編譯後緩存到內存中,而不會每次都被重新編譯,所以監聽模式的整體速度是很快的。

webpack --progress --colors --watch

當然,我們可以使用 webpack-dev-server 開發服務,這樣我們就能通過 localhost:8080 啟動一個 express 靜態資源 web 服務器,並且會以監聽模式自動運行 webpack,在瀏覽器打開 http://localhost:8080/ 或 http://localhost:8080/webpack-dev-server/ 可以瀏覽項目中的頁面和編譯後的資源輸出,並且通過一個 socket.io 服務實時監聽它們的變化並自動刷新頁面。

# 安裝 cnpm install webpack-dev-server -g # 運行 webpack-dev-server --progress --colors

在瀏覽器打開 http://localhost:8080/ 輸出結果如下:

技術分享

Webpack 入門教程