webpack 入門,超詳細

什麼是WebPack,爲什麼要使用它?

爲什要使用WebPack

現今的很多網頁其實可以看做是功能豐富的應用,它們擁有着複雜的JavaScript代碼和一大堆依賴包。爲了簡化開發的複雜度,前端社區涌現出了很多好的實踐方法

模塊化,讓我們可以把複雜的程序細化爲小的文件;
類似於TypeScript這種在JavaScript基礎上拓展的開發語言:使我們能夠實現目前版本的JavaScript不能直接使用的特性,並且之後還能轉換爲JavaScript文件使瀏覽器可以識別;
Scss,less等CSS預處理器

這些改進確實大大的提高了我們的開發效率,但是利用它們開發的文件往往需要進行額外的處理才能讓瀏覽器識別,而手動處理又是非常繁瑣的,這就爲WebPack類的工具的出現提供了需求。

什麼是Webpack

WebPack可以看做是模塊打包機:它做的事情是,分析你的項目結構,找到JavaScript模塊以及其它的一些瀏覽器不能直接運行的拓展語言(Scss,TypeScript等),並將其轉換和打包爲合適的格式供瀏覽器使用。

WebPack和Grunt以及Gulp相比有什麼特性

其實Webpack和另外兩個並沒有太多的可比性,Gulp/Grunt是一種能夠優化前端的開發流程的工具,而WebPack是一種模塊化的解決方案,不過Webpack的優點使得Webpack在很多場景下可以替代Gulp/Grunt類的工具。

Grunt和Gulp的工作方式是:在一個配置文件中,指明對某些文件進行類似編譯,組合,壓縮等任務的具體步驟,工具之後可以自動替你完成這些任務。

這裏寫圖片描述

Webpack的工作方式是:把你的項目當做一個整體,通過一個給定的主文件(如:index.js),Webpack將從這個文件開始找到你的項目的所有依賴文件,使用loaders處理它們,最後打包爲一個(或多個)瀏覽器可識別的JavaScript文件。

這裏寫圖片描述
如果實在要把二者進行比較,Webpack的處理速度更快更直接,能打包更多不同類型的文件。

開始使用Webpack

初步瞭解了Webpack工作方式後,我們一步步的開始學習使用Webpack。

安裝

Webpack可以使用npm安裝,新建一個空的練習文件夾(此處命名爲webpack sample project),在終端中轉到該文件夾後執行下述指令就可以完成安裝。

//全局安裝
npm install -g webpack
//安裝到你的項目目錄
npm install --save-dev webpack

正式使用Webpack前的準備

在上述練習文件夾中創建一個package.json文件,這是一個標準的npm說明文件,裏面蘊含了豐富的信息,包括當前項目的依賴模塊,自定義的腳本任務等等。在終端中使用npm init命令可以自動創建這個package.json文件

npm init

輸入這個命令後,終端會問你一系列諸如項目名稱,項目描述,作者等信息,不過不用擔心,如果你不準備在npm中發佈你的模塊,這些問題的答案都不重要,回車默認即可。

package.json文件已經就緒,我們在本項目中安裝Webpack作爲依賴包

// 安裝Webpack
npm install --save-dev webpack

回到之前的空文件夾,並在裏面創建兩個文件夾,app文件夾和public文件夾,app文件夾用來存放原始數據和我們將寫的JavaScript模塊,public文件夾用來存放之後供瀏覽器讀取的文件(包括使用webpack打包生成的js文件以及一個index.html文件)。接下來我們再創建三個文件:

index.html --放在public文件夾中;
Greeter.js-- 放在app文件夾中;
main.js-- 放在app文件夾中;

此時項目結構如下圖所示
這裏寫圖片描述

我們在index.html文件中寫入最基礎的html代碼,它在這裏目的在於引入打包後的js文件(這裏我們先把之後打包後的js文件命名爲bundle.js,之後我們還會詳細講述)。

<!-- index.html -->
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <title>Webpack Sample Project</title>
  </head>
  <body>
    <div id='root'>
    </div>
    <script src="bundle.js"></script>
  </body>
</html>

我們在Greeter.js中定義一個返回包含問候信息的html元素的函數,並依據CommonJS規範導出這個函數爲一個模塊:

// Greeter.js
module.exports = function() {
  var greet = document.createElement('div');
  greet.textContent = "Hi there and greetings!";
  return greet;
};

main.js文件中我們寫入下述代碼,用以把Greeter模塊返回的節點插入頁面。

//main.js 
const greeter = require('./Greeter.js');
document.querySelector("#root").appendChild(greeter());

正式使用Webpack

webpack可以在終端中使用,在基本的使用方法如下:

{extry file}出填寫入口文件的路徑,本文中就是上述main.js的路徑,
{destination for bundled file}處填寫打包文件的存放路徑
填寫路徑的時候不用添加{}
webpack {entry file} {destination for bundled file}

指定入口文件後,webpack將自動識別項目所依賴的其它文件,不過需要注意的是如果你的webpack不是全局安裝的,那麼當你在終端中使用此命令時,需要額外指定其在node_modules中的地址,繼續上面的例子,在終端中輸入如下命令

webpack非全局安裝的情況

node_modules/.bin/webpack app/main.js public/bundle.js

結果如下
這裏寫圖片描述
可以看出webpack同時編譯了main.js 和Greeter,js,現在打開index.html就可以看到結果了.

有沒有很激動,已經成功的使用Webpack打包了一個文件了。不過在終端中進行復雜的操作,其實是不太方便且容易出錯的,接下來看看Webpack的另一種更常見的使用方法。

通過配置文件來使用Webpack

Webpack擁有很多其它的比較高級的功能(比如說本文後面會介紹的loaders和plugins),這些功能其實都可以通過命令行模式實現,但是正如前面提到的,這樣不太方便且容易出錯的,更好的辦法是定義一個配置文件,這個配置文件其實也是一個簡單的JavaScript模塊,我們可以把所有的與打包相關的信息放在裏面。

繼續上面的例子來說明如何寫這個配置文件,在當前練習文件夾的根目錄下新建一個名爲webpack.config.js的文件,我們在其中寫入如下所示的簡單配置代碼,目前的配置主要涉及到的內容是入口文件路徑和打包後文件的存放路徑。

module.exports = {
  entry:  __dirname + "/app/main.js",//已多次提及的唯一入口文件
  output: {
    path: __dirname + "/public",//打包後的文件存放的地方
    filename: "bundle.js"//打包後輸出文件的文件名
  }
}
注:“__dirname”是node.js中的一個全局變量,它指向當前執行腳本所在的目錄。

有了這個配置之後,再打包文件,只需在終端裏運行webpack(非全局安裝需使用node_modules/.bin/webpack)命令就可以了,這條命令會自動引用webpack.config.js文件中的配置選項,示例如下:

這裏寫圖片描述

又學會了一種使用Webpack的方法,這種方法不用管那煩人的命令行參數,有沒有感覺很爽。如果我們可以連webpack(非全局安裝需使用node_modules/.bin/webpack)這條命令都可以不用,那種感覺會不會更爽~,繼續看下文。

更快捷的執行打包任務

在命令行中輸入命令需要代碼類似於node_modules/.bin/webpack這樣的路徑其實是比較煩人的,不過值得慶幸的是npm可以引導任務執行,對npm進行配置後可以在命令行中使用簡單的npm start命令來替代上面略微繁瑣的命令。在package.json中對scripts對象進行相關設置即可,設置方法如下。

{
  "name": "webpack-sample-project",
  "version": "1.0.0",
  "description": "Sample webpack project",
  "scripts": {
    "start": "webpack" // 修改的是這裏,JSON文件不支持註釋,引用時請清除
  },
  "author": "zhang",
  "license": "ISC",
  "devDependencies": {
    "webpack": "^1.12.9"
  }
}
注:package.json中的script會安裝一定順序尋找命令對應位置,本地的node_modules/.bin路徑就在這個尋找清單中,所以無論是全局還是局部安裝的Webpack,你都不需要寫前面那指明詳細的路徑了。

npm的start命令是一個特殊的腳本名稱,其特殊性表現在,在命令行中使用npm start就可以執行其對於的命令,如果對應的此腳本名稱不是start,想要在命令行中運行時,需要這樣用npm run {script name}如npm run build,我們在命令行中輸入npm start試試,輸出結果如下:

這裏寫圖片描述

現在只需要使用npm start就可以打包文件了,有沒有覺得webpack也不過如此嘛,不過不要太小瞧webpack,要充分發揮其強大的功能我們需要修改配置文件的其它選項,一項項來看。

Webpack的強大功能

生成Source Maps(使調試更容易)

開發總是離不開調試,方便的調試能極大的提高開發效率,不過有時候通過打包後的文件,你是不容易找到出錯了的地方,對應的你寫的代碼的位置的,Source Maps就是來幫我們解決這個問題的。

通過簡單的配置,webpack就可以在打包時爲我們生成的source maps,這爲我們提供了一種對應編譯文件和源文件的方法,使得編譯後的代碼可讀性更高,也更容易調試。

在webpack的配置文件中配置source maps,需要配置devtool,對小到中型的項目中,eval-source-map是一個很好的選項,再次強調你只應該開發階段使用它,我們繼續對上文新建的webpack.config.js,進行如下配置:

module.exports = {
  devtool: 'eval-source-map',
  entry:  __dirname + "/app/main.js",
  output: {
    path: __dirname + "/public",
    filename: "bundle.js"
  }
}
cheap-module-eval-source-map方法構建速度更快,但是不利於調試,推薦在大型項目考慮時間成本時使用。

使用webpack構建本地服務器

想不想讓你的瀏覽器監聽你的代碼的修改,並自動刷新顯示修改後的結果,其實Webpack提供一個可選的本地開發服務器,這個本地服務器基於node.js構建,可以實現你想要的這些功能,不過它是一個單獨的組件,在webpack中進行配置之前需要單獨安裝它作爲項目依賴

npm install --save-dev webpack-dev-server

devserver作爲webpack配置選項中的一項,以下是它的一些配置選項,更多配置可參考這裏

contentBase:    默認webpack-dev-server會爲根文件夾提供本地服務器,如果想爲另外一個目錄下的文件提供本地服務器,應該在這裏設置其所在目錄(本例設置到“public"目錄)

port:   設置默認監聽端口,如果省略,默認爲”8080“

inline:設置爲true,當源文件改變時會自動刷新頁面

historyApiFallback: 在開發單頁應用時非常有用,它依賴於HTML5 history API,如果設置爲true,所有的跳轉將指向index.html

把這些命令加到webpack的配置文件中,現在的配置文件webpack.config.js如下所示

module.exports = {
  devtool: 'eval-source-map',

  entry:  __dirname + "/app/main.js",
  output: {
    path: __dirname + "/public",
    filename: "bundle.js"
  },

  devServer: {
    contentBase: "./public",//本地服務器所加載的頁面所在的目錄
    historyApiFallback: true,//不跳轉
    inline: true,//實時刷新
    port:8081
  } 
}

在package.json中的scripts對象中添加如下命令,用以開啓本地服務器:

"scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "start": "webpack",
    "server": "webpack-dev-server --open"
  },

在終端中輸入npm run server即可在本地的8081端口查看結果
這裏寫圖片描述

Loaders

鼎鼎大名的Loaders登場了!

Loaderswebpack提供的最激動人心的功能之一了。通過使用不同的loader,webpack有能力調用外部的腳本或工具,實現對不同格式的文件的處理,比如說分析轉換scss爲css,或者把下一代的JS文件(ES6,ES7)轉換爲現代瀏覽器兼容的JS文件,對React的開發而言,合適的Loaders可以把React的中用到的JSX文件轉換爲JS文件。

Loaders需要單獨安裝並且需要在webpack.config.js中的modules關鍵字下進行配置,Loaders的配置包括以下幾方面:

**test**:一個用以匹配loaders所處理文件的拓展名的正則表達式(必須)
**loader**:loader的名稱(必須)
**include/exclude**:手動添加必須處理的文件(文件夾)或屏蔽不需要處理的文件(文件夾)(可選);
**query**:爲loaders提供額外的設置選項(可選)

不過在配置loader之前,我們把Greeter.js裏的問候消息放在一個單獨的JSON文件裏,並通過合適的配置使Greeter.js可以讀取該JSON文件的值,各文件修改後的代碼如下:
在app文件夾中創建帶有問候信息的JSON文件(命名爲config.json)

{
  "greetText": "Hi there and greetings from JSON!"
}

更新後的Greeter.js

var config = require('./config.json');

module.exports = function() {
  var greet = document.createElement('div');
  greet.textContent = config.greetText;
  return greet;
};
注 由於webpack3.*/webpack2.*已經內置可處理JSON文件,這裏我們無需再添加webpack1.*需要的json-loader。在看如何具體使用loader之前我們先看看Babel是什麼?

Babel

Babel其實是一個編譯JavaScript的平臺,它的強大之處表現在可以通過編譯幫你達到以下目的:

使用下一代的JavaScript代碼(ES6,ES7…),即使這些標準目前並未被當前的瀏覽器完全的支持;
使用基於JavaScript進行了拓展的語言,比如React的JSX;

Babel的安裝與配置

Babel其實是幾個模塊化的包,其核心功能位於稱爲babel-core的npm包中,webpack可以把其不同的包整合在一起使用,對於每一個你需要的功能或拓展,你都需要安裝單獨的包(用得最多的是解析Es6的babel-preset-es2015包和解析JSX的babel-preset-react包)。

我們先來一次性安裝這些依賴包

// npm一次性安裝多個依賴模塊,模塊之間用空格隔開

npm install --save-dev babel-core babel-loader babel-preset-es2015 babel-preset-react

在webpack中配置Babel的方法如下:

module.exports = {
    entry: __dirname + "/app/main.js",//已多次提及的唯一入口文件
    output: {
        path: __dirname + "/public",//打包後的文件存放的地方
        filename: "bundle.js"//打包後輸出文件的文件名
    },
    devtool: 'eval-source-map',
    devServer: {
        contentBase: "./public",//本地服務器所加載的頁面所在的目錄
        historyApiFallback: true,//不跳轉
        inline: true//實時刷新
    },
    module: {
        rules: [
            {
                test: /(\.jsx|\.js)$/,
                use: {
                    loader: "babel-loader",
                    options: {
                        presets: [
                            "es2015", "react"
                        ]
                    }
                },
                exclude: /node_modules/
            }
        ]
    }
};

現在你的webpack的配置已經允許你使用ES6以及JSX的語法了。繼續用上面的例子進行測試,不過這次我們會使用React,記得先安裝 ReactReact-DOM

npm install --save react react-dom

接下來我們使用ES6的語法,更新Greeter.js並返回一個React組件

//Greeter,js
import React, {Component} from 'react'
import config from './config.json';

class Greeter extends Component{
  render() {
    return (
      <div>
        {config.greetText}
      </div>
    );
  }
}

export default Greeter

修改main.js如下,使用ES6的模塊定義和渲染Greeter模塊

// main.js
import React from 'react';
import {render} from 'react-dom';
import Greeter from './Greeter';

render(<Greeter />, document.getElementById('root'));

重新使用npm start打包,如果之前打開的本地服務器沒有關閉,你應該可以在localhost:8080下看到與之前一樣的內容,這說明react和es6被正常打包了。

Babel的配置

Babel其實可以完全在 webpack.config.js 中進行配置,但是考慮到babel具有非常多的配置選項,在單一的webpack.config.js文件中進行配置往往使得這個文件顯得太複雜,因此一些開發者支持把babel的配置選項放在一個單獨的名爲 “.babelrc” 的配置文件中。我們現在的babel的配置並不算複雜,不過之後我們會再加一些東西,因此現在我們就提取出相關部分,分兩個配置文件進行配置(webpack會自動調用.babelrc裏的babel配置選項),如下:

module.exports = {
    entry: __dirname + "/app/main.js",//已多次提及的唯一入口文件
    output: {
        path: __dirname + "/public",//打包後的文件存放的地方
        filename: "bundle.js"//打包後輸出文件的文件名
    },
    devtool: 'eval-source-map',
    devServer: {
        contentBase: "./public",//本地服務器所加載的頁面所在的目錄
        historyApiFallback: true,//不跳轉
        inline: true//實時刷新
    },
    module: {
        rules: [
            {
                test: /(\.jsx|\.js)$/,
                use: {
                    loader: "babel-loader"
                },
                exclude: /node_modules/
            }
        ]
    }
};
//.babelrc
{
  "presets": ["react", "es2015"]
}

到目前爲止,我們已經知道了,對於模塊,Webpack能提供非常強大的處理功能,那那些是模塊呢。

一切皆模塊

Webpack有一個不可不說的優點,它把所有的文件都都當做模塊處理,JavaScript代碼,CSS和fonts以及圖片等等通過合適的loader都可以被處理。

CSS

webpack提供兩個工具處理樣式表,css-loader 和 style-loader,二者處理的任務不同,css-loader使你能夠使用類似@import 和 url(…)的方法實現 require()的功能,style-loader將所有的計算後的樣式加入頁面中,二者組合在一起使你能夠把樣式表嵌入webpack打包後的JS文件中。
繼續上面的例子

//安裝
npm install --save-dev style-loader css-loader

//使用

module.exports = {

   ...
    module: {
        rules: [
            {
                test: /(\.jsx|\.js)$/,
                use: {
                    loader: "babel-loader"
                },
                exclude: /node_modules/
            },
            {
                test: /\.css$/,
                use: [
                    {
                        loader: "style-loader"
                    }, {
                        loader: "css-loader"
                    }
                ]
            }
        ]
    }
};
請注意這裏對同一個文件引入多個loader的方法。

接下來,在app文件夾裏創建一個名字爲”main.css”的文件,對一些元素設置樣式

/* main.css */
html {
  box-sizing: border-box;
  -ms-text-size-adjust: 100%;
  -webkit-text-size-adjust: 100%;
}

*, *:before, *:after {
  box-sizing: inherit;
}

body {
  margin: 0;
  font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif;
}

h1, h2, h3, h4, h5, h6, p, ul {
  margin: 0;
  padding: 0;
}

我們這裏例子中用到的webpack只有單一的入口,其它的模塊需要通過 import, require, url等與入口文件建立其關聯,爲了讓webpack能找到”main.css“文件,我們把它導入”main.js “中,如下

//main.js
import React from 'react';
import {render} from 'react-dom';
import Greeter from './Greeter';

import './main.css';//使用require導入css文件

render(<Greeter />, document.getElementById('root'));

通常情況下,css會和js打包到同一個文件中,並不會打包爲一個單獨的css文件,不過通過合適的配置webpack也可以把css打包爲單獨的文件的。

上面的代碼說明webpack是怎麼把css當做模塊看待的,咱們繼續看一個更加真實的css模塊實踐。

CSS module
在過去的一些年裏,JavaScript通過一些新的語言特性,更好的工具以及更好的實踐方法(比如說模塊化)發展得非常迅速。模塊使得開發者把複雜的代碼轉化爲小的,乾淨的,依賴聲明明確的單元,配合優化工具,依賴管理和加載管理可以自動完成。

不過前端的另外一部分,CSS發展就相對慢一些,大多的樣式表卻依舊巨大且充滿了全局類名,維護和修改都非常困難。

最近有一個叫做 CSS modules 的技術就意在把JS的模塊化思想帶入CSS中來,通過CSS模塊,所有的類名,動畫名默認都只作用於當前模塊。Webpack從一開始就對CSS模塊化提供了支持,在CSS loader中進行配置後,你所需要做的一切就是把”modules“傳遞到所需要的地方,然後就可以直接把CSS的類名傳遞到組件的代碼中,且這樣做只對當前組件有效,不必擔心在不同的模塊中使用相同的類名造成衝突。具體的代碼如下

module.exports = {

    ...

    module: {
        rules: [
            {
                test: /(\.jsx|\.js)$/,
                use: {
                    loader: "babel-loader"
                },
                exclude: /node_modules/
            },
            {
                test: /\.css$/,
                use: [
                    {
                        loader: "style-loader"
                    }, {
                        loader: "css-loader",
                        options: {
                            modules: true
                        }
                    }
                ]
            }
        ]
    }
};

在app文件夾下創建一個Greeter.css文件

.root {
  background-color: #eee;
  padding: 10px;
  border: 3px solid #ccc;
}

導入.root到Greeter.js中

import React, {Component} from 'react';
import config from './config.json';
import styles from './Greeter.css';//導入

class Greeter extends Component{
  render() {
    return (
      <div className={styles.root}>//添加類名
        {config.greetText}
      </div>
    );
  }
}

export default Greeter

放心使用把,相同的類名也不會造成不同組件之間的污染。

CSS modules 也是一個很大的主題,有興趣的話可以去官方文檔查看更多消息

CSS預處理器
Sass 和 Less 之類的預處理器是對原生CSS的拓展,它們允許你使用類似於variables, nesting, mixins, inheritance等不存在於CSS中的特性來寫CSS,CSS預處理器可以這些特殊類型的語句轉化爲瀏覽器可識別的CSS語句,

你現在可能都已經熟悉了,在webpack裏使用相關loaders進行配置就可以使用了,以下是常用的CSS 處理loaders:

Less Loader
Sass Loader
Stylus Loader

不過其實也存在一個CSS的處理平臺-PostCSS,它可以幫助你的CSS實現更多的功能,在其官方文檔可瞭解更多相關知識。

舉例來說如何使用PostCSS,我們使用PostCSS來爲CSS代碼自動添加適應不同瀏覽器的CSS前綴。

首先安裝postcss-loader 和 autoprefixer(自動添加前綴的插件)

npm install --save-dev postcss-loader autoprefixer

接下來,在webpack配置文件中添加postcss-loader,在根目錄新建postcss.config.js,並添加如下代碼之後,重新使用npm start打包時,你寫的css會自動根據Can i use裏的數據添加不同前綴了。

//webpack.config.js
module.exports = {
    ...
    module: {
        rules: [
            {
                test: /(\.jsx|\.js)$/,
                use: {
                    loader: "babel-loader"
                },
                exclude: /node_modules/
            },
            {
                test: /\.css$/,
                use: [
                    {
                        loader: "style-loader"
                    }, {
                        loader: "css-loader",
                        options: {
                            modules: true
                        }
                    }, {
                        loader: "postcss-loader"
                    }
                ]
            }
        ]
    }
}
// postcss.config.js
module.exports = {
    plugins: [
        require('autoprefixer')
    ]
}

至此,本文已經談論了處理JS的Babel和處理CSS的PostCSS的基本用法,它們其實也是兩個單獨的平臺,配合webpack可以很好的發揮它們的作用。接下來介紹Webpack中另一個非常重要的功能-Plugins

插件(Plugins)
插件(Plugins)是用來拓展Webpack功能的,它們會在整個構建過程中生效,執行相關的任務。
Loaders和Plugins常常被弄混,但是他們其實是完全不同的東西,可以這麼來說,loaders是在打包構建過程中用來處理源文件的(JSX,Scss,Less..),一次處理一個,插件並不直接操作單個文件,它直接對整個構建過程其作用。

Webpack有很多內置插件,同時也有很多第三方插件,可以讓我們完成更加豐富的功能。

使用插件的方法

要使用某個插件,我們需要通過npm安裝它,然後要做的就是在webpack配置中的plugins關鍵字部分添加該插件的一個實例(plugins是一個數組)繼續上面的例子,我們添加了一個給打包後代碼添加版權聲明的插件

const webpack = require('webpack');

module.exports = {
...
    module: {
        rules: [
            {
                test: /(\.jsx|\.js)$/,
                use: {
                    loader: "babel-loader"
                },
                exclude: /node_modules/
            },
            {
                test: /\.css$/,
                use: [
                    {
                        loader: "style-loader"
                    }, {
                        loader: "css-loader",
                        options: {
                            modules: true
                        }
                    }, {
                        loader: "postcss-loader"
                    }
                ]
            }
        ]
    },
    plugins: [
        new webpack.BannerPlugin('版權所有,翻版必究')
    ],
};

通過這個插件,打包後的JS文件顯示如下

這裏寫圖片描述
這就是webpack插件的基礎用法了,下面給大家推薦幾個常用的插件

HtmlWebpackPlugin
這個插件的作用是依據一個簡單的index.html模板,生成一個自動引用你打包後的JS文件的新index.html。這在每次生成的js文件名稱不同時非常有用(比如添加了hash值)。

安裝

npm install --save-dev html-webpack-plugin

這個插件自動完成了我們之前手動做的一些事情,在正式使用之前需要對一直以來的項目結構做一些更改:

移除public文件夾,利用此插件,index.html文件會自動生成,此外CSS已經通過前面的操作打包到JS中了。
在app目錄下,創建一個index.tmpl.html文件模板,這個模板包含title等必須元素,在編譯過程中,插件會依據此模板生成最終的html頁面,會自動添加所依賴的 css, js,favicon等文件,index.tmpl.html中的模板源代碼如下:

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <title>Webpack Sample Project</title>
  </head>
  <body>
    <div id='root'>
    </div>
  </body>
</html>

3.更新webpack的配置文件,方法同上,新建一個build文件夾用來存放最終的輸出文件

const webpack = require('webpack');
const HtmlWebpackPlugin = require('html-webpack-plugin');

module.exports = {
    entry: __dirname + "/app/main.js",//已多次提及的唯一入口文件
    output: {
        path: __dirname + "/build",
        filename: "bundle.js"
    },
    devtool: 'eval-source-map',
    devServer: {
        contentBase: "./public",//本地服務器所加載的頁面所在的目錄
        historyApiFallback: true,//不跳轉
        inline: true//實時刷新
    },
    module: {
        rules: [
            {
                test: /(\.jsx|\.js)$/,
                use: {
                    loader: "babel-loader"
                },
                exclude: /node_modules/
            },
            {
                test: /\.css$/,
                use: [
                    {
                        loader: "style-loader"
                    }, {
                        loader: "css-loader",
                        options: {
                            modules: true
                        }
                    }, {
                        loader: "postcss-loader"
                    }
                ]
            }
        ]
    },
    plugins: [
        new webpack.BannerPlugin('版權所有,翻版必究'),
        new HtmlWebpackPlugin({
            template: __dirname + "/app/index.tmpl.html"//new 一個這個插件的實例,並傳入相關的參數
        })
    ],
};

再次執行npm start你會發現,build文件夾下面生成了bundle.js和index.html。

這裏寫圖片描述

Hot Module Replacement
Hot Module Replacement(HMR)也是webpack裏很有用的一個插件,它允許你在修改組件代碼後,自動刷新實時預覽修改後的效果。

在webpack中實現HMR也很簡單,只需要做兩項配置

1.在webpack配置文件中添加HMR插件;

2.在Webpack Dev Server中添加“hot”參數;

不過配置完這些後,JS模塊其實還是不能自動熱加載的,還需要在你的JS模塊中執行一個Webpack提供的API才能實現熱加載,雖然這個API不難使用,但是如果是React模塊,使用我們已經熟悉的Babel可以更方便的實現功能熱加載。

整理下我們的思路,具體實現方法如下

Babel和webpack是獨立的工具
二者可以一起工作
二者都可以通過插件拓展功能
HMR是一個webpack插件,它讓你能瀏覽器中實時觀察模塊修改後的效果,但是如果你想讓它工作,需要對模塊進行額外的配額;
Babel有一個叫做react-transform-hrm的插件,可以在不對React模塊進行額外的配置的前提下讓HMR正常工作;

還是繼續上例來實際看看如何配置

const webpack = require('webpack');
const HtmlWebpackPlugin = require('html-webpack-plugin');

module.exports = {
    entry: __dirname + "/app/main.js",//已多次提及的唯一入口文件
    output: {
        path: __dirname + "/build",
        filename: "bundle.js"
    },
    devtool: 'eval-source-map',
    devServer: {
        contentBase: "./public",//本地服務器所加載的頁面所在的目錄
        historyApiFallback: true,//不跳轉
        inline: true,
        hot: true
    },
    module: {
        rules: [
            {
                test: /(\.jsx|\.js)$/,
                use: {
                    loader: "babel-loader"
                },
                exclude: /node_modules/
            },
            {
                test: /\.css$/,
                use: [
                    {
                        loader: "style-loader"
                    }, {
                        loader: "css-loader",
                        options: {
                            modules: true
                        }
                    }, {
                        loader: "postcss-loader"
                    }
                ]
            }
        ]
    },
    plugins: [
        new webpack.BannerPlugin('版權所有,翻版必究'),
        new HtmlWebpackPlugin({
            template: __dirname + "/app/index.tmpl.html"//new 一個這個插件的實例,並傳入相關的參數
        }),
        new webpack.HotModuleReplacementPlugin()//熱加載插件
    ],
};
安裝react-transform-hmr

npm install --save-dev babel-plugin-react-transform react-transform-hmr

配置Babel

// .babelrc
{
  "presets": ["react", "es2015"],
  "env": {
    "development": {
    "plugins": [["react-transform", {
       "transforms": [{
         "transform": "react-transform-hmr",

         "imports": ["react"],

         "locals": ["module"]
       }]
     }]]
    }
  }
}

現在當你使用React時,可以熱加載模塊了,每次保存就能在瀏覽器上看到更新內容。

產品階段的構建

目前爲止,我們已經使用webpack構建了一個完整的開發環境。但是在產品階段,可能還需要對打包的文件進行額外的處理,比如說優化,壓縮,緩存以及分離CSS和JS。

對於複雜的項目來說,需要複雜的配置,這時候分解配置文件爲多個小的文件可以使得事情井井有條,以上面的例子來說,我們創建一個webpack.production.config.js的文件,在裏面加上基本的配置,它和原始的webpack.config.js很像,如下

// webpack.production.config.js
const webpack = require('webpack');
const HtmlWebpackPlugin = require('html-webpack-plugin');

module.exports = {
    entry: __dirname + "/app/main.js", //已多次提及的唯一入口文件
    output: {
        path: __dirname + "/build",
        filename: "bundle.js"
    },
    devtool: 'eval-source-map',
    devServer: {
        contentBase: "./public", //本地服務器所加載的頁面所在的目錄
        historyApiFallback: true, //不跳轉
        inline: true,
        hot: true
    },
    module: {
        rules: [{
            test: /(\.jsx|\.js)$/,
            use: {
                loader: "babel-loader"
            },
            exclude: /node_modules/
        }, {
            test: /\.css$/,
            use: ExtractTextPlugin.extract({
                fallback: "style-loader",
                use: [{
                    loader: "css-loader",
                    options: {
                        modules: true
                    }
                }, {
                    loader: "postcss-loader"
                }],
            })
        }]
    },
    plugins: [
        new webpack.BannerPlugin('版權所有,翻版必究'),
        new HtmlWebpackPlugin({
            template: __dirname + "/app/index.tmpl.html" //new 一個這個插件的實例,並傳入相關的參數
        }),
        new webpack.HotModuleReplacementPlugin() //熱加載插件
    ],
};
//package.json
{
  "name": "test",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "start": "webpack",
    "server": "webpack-dev-server --open",
    "build": "NODE_ENV=production webpack --config ./webpack.production.config.js --progress"
  },
  "author": "",
  "license": "ISC",
  "devDependencies": {
...
  },
  "dependencies": {
    "react": "^15.6.1",
    "react-dom": "^15.6.1"
  }
}

優化插件

webpack提供了一些在發佈階段非常有用的優化插件,它們大多來自於webpack社區,可以通過npm安裝,通過以下插件可以完成產品發佈階段所需的功能

1.OccurenceOrderPlugin :爲組件分配ID,通過這個插件webpack可以分析和優先考慮使用最多的模塊,併爲它們分配最小的ID
2.UglifyJsPlugin:壓縮JS代碼;
3.ExtractTextPlugin:分離CSS和JS文件

我們繼續用例子來看看如何添加它們,OccurenceOrder 和 UglifyJS plugins 都是內置插件,你需要做的只是安裝其它非內置插件

npm install --save-dev extract-text-webpack-plugin

在配置文件的plugins後引用它們

// webpack.production.config.js
const webpack = require('webpack');
const HtmlWebpackPlugin = require('html-webpack-plugin');
const ExtractTextPlugin = require('extract-text-webpack-plugin');

module.exports = {
    entry: __dirname + "/app/main.js",//已多次提及的唯一入口文件
    output: {
        path: __dirname + "/build",
        filename: "bundle.js"
    },
    devtool: 'none',
    devServer: {
        contentBase: "./public",//本地服務器所加載的頁面所在的目錄
        historyApiFallback: true,//不跳轉
        inline: true,
        hot: true
    },
    module: {
        rules: [
            {
                test: /(\.jsx|\.js)$/,
                use: {
                    loader: "babel-loader"
                },
                exclude: /node_modules/
            },
            {
                test: /\.css$/,
                use: [
                    {
                        loader: "style-loader"
                    }, {
                        loader: "css-loader",
                        options: {
                            modules: true
                        }
                    }, {
                        loader: "postcss-loader"
                    }
                ]
            }
        ]
    },
    plugins: [
        new webpack.BannerPlugin('版權所有,翻版必究'),
        new HtmlWebpackPlugin({
            template: __dirname + "/app/index.tmpl.html"
        }),
        new webpack.optimize.OccurrenceOrderPlugin(),
        new webpack.optimize.UglifyJsPlugin(),
        new ExtractTextPlugin("style.css")
    ],
};

此時執行npm run build可以看見代碼是被壓縮後的
這裏寫圖片描述

緩存

緩存無處不在,使用緩存的最好方法是保證你的文件名和文件內容是匹配的(內容改變,名稱相應改變)

webpack可以把一個哈希值添加到打包的文件名中,使用方法如下,添加特殊的字符串混合體([name], [id] and [hash])到輸出文件名前

const webpack = require('webpack');
const HtmlWebpackPlugin = require('html-webpack-plugin');
const ExtractTextPlugin = require('extract-text-webpack-plugin');

module.exports = {
..
    output: {
        path: __dirname + "/build",
        filename: "bundle-[hash].js"
    },
   ...
};

現在用戶會有合理的緩存了。
這裏寫圖片描述

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章