轉：入門Webpack，看這篇就夠了

時間  2019-11-19
標籤 入門 webpack 看這 夠了 简体版
原文   原文鏈接

寫在前面的話

閱讀本文以前，先看下面這個webpack的配置文件，若是每一項你都懂，那本文能帶給你的收穫也許就比較有限，你能夠快速瀏覽或直接跳過；若是你和十天前的我同樣，對不少選項存在着疑惑，那花一段時間慢慢閱讀本文，你的疑惑必定一個一個都會消失；若是你之前沒怎麼接觸過Webpack，而你又你對webpack感興趣，那麼動手跟着本文中那個貫穿始終的例子寫一次，寫完之後你會發現你已明明白白的走進了Webpack的大門。javascript

//一個常見的Webpack配置文件 var webpack = require('webpack'); var HtmlWebpackPlugin = require('html-webpack-plugin'); var ExtractTextPlugin = require('extract-text-webpack-plugin'); module.exports = { entry: __dirname + "/app/main.js", output: { path: __dirname + "/build", filename: "[name]-[hash].js" }, module: { loaders: [ { test: /\.json$/, loader: "json" }, { test: /\.js$/, exclude: /node_modules/, loader: 'babel' }, { test: /\.css$/, loader: ExtractTextPlugin.extract('style', 'css?modules!postcss') } ] }, postcss: [ require('autoprefixer') ], plugins: [ new HtmlWebpackPlugin({ template: __dirname + "/app/index.tmpl.html" }), new webpack.optimize.OccurenceOrderPlugin(), new webpack.optimize.UglifyJsPlugin(), new ExtractTextPlugin("[name]-[hash].css") ] }

什麼是WebPack，爲何要使用它？

爲什要使用WebPack

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

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

這些改進確實大大的提升了咱們的開發效率，可是利用它們開發的文件每每須要進行額外的處理才能讓瀏覽器識別,而手動處理又是很是反鎖的，這就爲WebPack類的工具的出現提供了需求。html

什麼是Webpack

WebPack能夠看作是模塊打包機：它作的事情是，分析你的項目結構，找到JavaScript模塊以及其它的一些瀏覽器不能直接運行的拓展語言（Scss，TypeScript等），並將其打包爲合適的格式以供瀏覽器使用。前端

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

其實Webpack和另外兩個並無太多的可比性，Gulp/Grunt是一種可以優化前端的開發流程的工具，而WebPack是一種模塊化的解決方案，不過Webpack的優勢使得Webpack能夠替代Gulp/Grunt類的工具。java

Grunt和Gulp的工做方式是：在一個配置文件中，指明對某些文件進行相似編譯，組合，壓縮等任務的具體步驟，這個工具以後能夠自動替你完成這些任務。node


Grunt和Gulp的工做流程

Webpack的工做方式是：把你的項目當作一個總體，經過一個給定的主文件（如：index.js），Webpack將從這個文件開始找到你的項目的全部依賴文件，使用loaders處理它們，最後打包爲一個瀏覽器可識別的JavaScript文件。react


Webpack工做方式

若是實在要把兩者進行比較，Webpack的處理速度更快更直接，能打包更多不一樣類型的文件。webpack

開始使用Webpack

初步瞭解了Webpack工做方式後，咱們一步步的開始學習使用Webpack。git

安裝

Webpack可使用npm安裝，新建一個空的練習文件夾（此處命名爲webpack sample progect），在終端中轉到該文件夾後執行下述指令就能夠完成安裝。github

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

正式使用Webpack前的準備

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

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

  1. package.json文件已經就緒，咱們在本項目中安裝Webpack做爲依賴包

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

  2. 回到以前的空文件夾，並在裏面建立兩個文件夾,app文件夾和public文件夾，app文件夾用來存放原始數據和咱們將寫的JavaScript模塊，public文件夾用來存放準備給瀏覽器讀取的數據（包括使用webpack生成的打包後的js文件以及一個index.html文件）。在這裏還須要建立三個文件，index.html 文件放在public文件夾中，兩個js文件（Greeter.js和main.js）放在app文件夾中，此時項目結構以下圖所示


    項目結構

index.html文件只有最基礎的html代碼，它惟一的目的就是加載打包後的js文件（bundle.js）

<!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元素的函數。

//main.js var greeter = require('./Greeter.js'); document.getElementById('root').appendChild(greeter());

main.js用來把Greeter模塊返回的節點插入頁面。

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

正式使用Webpack

webpack能夠在終端中使用，其最基礎的命令是

webpack {entry file/入口文件} {destination for bundled file/存放bundle.js的地方}

只須要指定一個入口文件，webpack將自動識別項目所依賴的其它文件，不過須要注意的是若是你的webpack沒有進行全局安裝，那麼當你在終端中使用此命令時，須要額外指定其在node_modules中的地址，繼續上面的例子，在終端中屬於以下命令

//webpack非全局安裝的狀況 node_modules/.bin/webpack app/main.js public/bundle.js

結果以下


termialResult1


能夠看出webpack同時編譯了main.js 和Greeter,js,如今打開index.html,能夠看到以下結果


htmlResult1


有沒有很激動，已經成功的使用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的方法，並且不用管那煩人的命令行參數了，有沒有感受很爽。有沒有想過若是能夠連webpack(非全局安裝需使用node_modules/.bin/webpack)這條命令均可以不用，那種感受會不會更爽~，繼續看下文。

更快捷的執行打包任務

執行相似於node_modules/.bin/webpack這樣的命令實際上是比較煩人且容易出錯的，不過值得慶幸的是npm能夠引導任務執行，對其進行配置後可使用簡單的npm start命令來代替這些繁瑣的命令。在package.json中對npm的腳本部分進行相關設置便可，設置方法以下。

{
  "name": "webpack-sample-project", "version": "1.0.0", "description": "Sample webpack project", "scripts": { "start": "webpack" //配置的地方就是這裏啦，至關於把npm的start命令指向webpack命令 }, "author": "zhang", "license": "ISC", "devDependencies": { "webpack": "^1.12.9" } }

注：package.json中的腳本部分已經默認在命令前添加了node_modules/.bin路徑，因此不管是全局仍是局部安裝的Webpack，你都不須要寫前面那指明詳細的路徑了。

npm的start是一個特殊的腳本名稱，它的特殊性表如今，在命令行中使用npm start就能夠執行相關命令，若是對應的此腳本名稱不是start，想要在命令行中運行時，須要這樣用npm run {script name}如npm run build，如下是執行npm start後命令行的輸出顯示


npmStartTermialResult

如今只須要使用npm start就能夠打包文件了，有沒有以爲webpack也不過如此嘛，不過不要過小瞧Webpack，其強大的功能包含在其一系列可供配置的選項中，咱們一項項來看。

Webpack的強大功能

生成Source Maps（使調試更容易）

開發老是離不開調試，若是能夠更加方便的調試固然就能提升開發效率，不過打包後的文件有時候你是不容易找到出錯了的地方對應的源代碼的位置的，Source Maps就是來幫咱們解決這個問題的。
經過簡單的配置後，Webpack在打包時能夠爲咱們生成的source maps，這爲咱們提供了一種對應編譯文件和源文件的方法，使得編譯後的代碼可讀性更高，也更容易調試。

在webpack的配置文件中配置source maps，須要配置devtool，它有如下四種不一樣的配置選項，各具優缺點，描述以下：

devtool選項 配置結果
source-map 在一個單獨的文件中產生一個完整且功能徹底的文件。這個文件具備最好的source map，可是它會減慢打包文件的構建速度；
cheap-module-source-map 在一個單獨的文件中生成一個不帶列映射的map，不帶列映射提升項目構建速度，可是也使得瀏覽器開發者工具只能對應到具體的行，不能對應到具體的列（符號），會對調試形成不便；
eval-source-map 使用eval打包源文件模塊，在同一個文件中生成乾淨的完整的source map。這個選項能夠在不影響構建速度的前提下生成完整的sourcemap，可是對打包後輸出的JS文件的執行具備性能和安全的隱患。不過在開發階段這是一個很是好的選項，可是在生產階段必定不要用這個選項；
cheap-module-eval-source-map 這是在打包文件時最快的生成source map的方法，生成的Source Map 會和打包後的JavaScript文件同行顯示，沒有列映射，和eval-source-map選項具備類似的缺點；

正如上表所述，上述選項由上到下打包速度愈來愈快，不過同時也具備愈來愈多的負面做用，較快的構建速度的後果就是對打包後的文件的的執行有必定影響。

在學習階段以及在小到中性的項目上，eval-source-map是一個很好的選項，不過記得只在開發階段使用它，繼續上面的例子，進行以下配置

module.exports = { devtool: 'eval-source-map',//配置生成Source Maps，選擇合適的選項 entry: __dirname + "/app/main.js", output: { path: __dirname + "/public", filename: "bundle.js" } }

cheap-module-eval-source-map方法構建速度更快，可是不利於調試，推薦在大型項目考慮da時間成本是使用。

使用webpack構建本地服務器

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

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

devserver做爲webpack配置選項中的一項，具備如下配置選項

devserver配置選項 功能描述
contentBase 默認webpack-dev-server會爲根文件夾提供本地服務器，若是想爲另一個目錄下的文件提供本地服務器，應該在這裏設置其所在目錄（本例設置到「public"目錄）
port 設置默認監聽端口，若是省略，默認爲」8080「
inline 設置爲true，當源文件改變時會自動刷新頁面
colors 設置爲true，使終端輸出的文件爲彩色的
historyApiFallback 在開發單頁應用時很是有用，它依賴於HTML5 history API，若是設置爲true，全部的跳轉將指向index.html

繼續把這些命令加到webpack的配置文件中，如今的配置文件以下所示

module.exports = { devtool: 'eval-source-map', entry: __dirname + "/app/main.js", output: { path: __dirname + "/public", filename: "bundle.js" }, devServer: { contentBase: "./public",//本地服務器所加載的頁面所在的目錄 colors: true,//終端中輸出結果爲彩色 historyApiFallback: true,//不跳轉 inline: true//實時刷新 } }

Loaders

鼎鼎大名的Loaders登場了！

Loaders是webpack中最讓人激動人心的功能之一了。經過使用不一樣的loader，webpack經過調用外部的腳本或工具能夠對各類各樣的格式的文件進行處理，好比說分析JSON文件並把它轉換爲JavaScript文件，或者說把下一代的JS文件（ES6，ES7)轉換爲現代瀏覽器能夠識別的JS文件。或者說對React的開發而言，合適的Loaders能夠把React的JSX文件轉換爲JS文件。

Loaders須要單獨安裝而且須要在webpack.config.js下的modules關鍵字下進行配置，Loaders的配置選項包括如下幾方面：

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

繼續上面的例子，咱們把Greeter.js裏的問候消息放在一個單獨的JSON文件裏,並經過合適的配置使Greeter.js能夠讀取該JSON文件的值，配置方法以下

//安裝能夠裝換JSON的loader
npm install --save-dev json-loader
module.exports = { devtool: 'eval-source-map', entry: __dirname + "/app/main.js", output: { path: __dirname + "/public", filename: "bundle.js" }, module: {//在配置文件裏添加JSON loader loaders: [ { test: /\.json$/, loader: "json" } ] }, devServer: { contentBase: "./public", colors: true, historyApiFallback: true, inline: true } }

建立帶有問候信息的JSON文件(命名爲config.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; };

Loaders很好，不過有的Loaders使用起來比較複雜，好比說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 = { devtool: 'eval-source-map', entry: __dirname + "/app/main.js", output: { path: __dirname + "/public", filename: "bundle.js" }, module: { loaders: [ { test: /\.json$/, loader: "json" }, { test: /\.js$/, exclude: /node_modules/, loader: 'babel',//在webpack的module部分的loaders裏進行配置便可 query: { presets: ['es2015','react'] } } ] }, devServer: { contentBase: "./public", colors: true, historyApiFallback: true, inline: true } }

如今你的webpack的配置已經容許你使用ES6以及JSX的語法了。繼續用上面的例子進行測試，不過此次咱們會使用React，記得先安裝 React 和 React-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

使用ES6的模塊定義和渲染Greeter模塊

import React from 'react'; import {render} from 'react-dom'; import Greeter from './Greeter'; render(<Greeter />, document.getElementById('root'));

Babel的配置選項

Babel其實能夠徹底在webpack.config.js中進行配置，可是考慮到babel具備很是多的配置選項，在單一的webpack.config.js文件中進行配置每每使得這個文件顯得太複雜，所以一些開發者支持把babel的配置選項放在一個單獨的名爲 ".babelrc" 的配置文件中。咱們如今的babel的配置並不算複雜，不過以後咱們會再加一些東西，所以如今咱們就提取出相關部分，分兩個配置文件進行配置（webpack會自動調用.babelrc裏的babel配置選項），以下：

// webpack.config.js module.exports = { devtool: 'eval-source-map', entry: __dirname + "/app/main.js", output: { path: __dirname + "/public", filename: "bundle.js" }, module: { loaders: [ { test: /\.json$/, loader: "json" }, { test: /\.js$/, exclude: /node_modules/, loader: 'babel' } ] }, devServer: {...} // Omitted for brevity }
//.babelrc { "presets": ["react", "es2015"] }

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

一切皆模塊

Webpack有一個不可不說的優勢，它把全部的文件均可以當作模塊處理，包括你的JavaScript代碼，也包括CSS和fonts以及圖片等等等，只有經過合適的loaders，它們均可以被當作模塊被處理。

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 = { devtool: 'eval-source-map', entry: __dirname + "/app/main.js", output: { path: __dirname + "/build", filename: "bundle.js" }, module: { loaders: [ { test: /\.json$/, loader: "json" }, { test: /\.js$/, exclude: /node_modules/, loader: 'babel' }, { test: /\.css$/, loader: 'style!css'//添加對樣式表的處理 } ] }, devServer: {...} }

注：感嘆號的做用在於使同一文件可以使用不一樣類型的loader

接下來，在app文件夾裏建立一個名字爲"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 = { devtool: 'eval-source-map', entry: __dirname + "/app/main.js", output: {...}, module: { loaders: [ { test: /\.json$/, loader: "json" }, { test: /\.js$/, exclude: /node_modules/, loader: 'babel' }, { test: /\.css$/, loader: 'style!css?modules'//跟前面相比就在後面加上了?modules } ] }, devServer: {...} }

建立一個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實現更多的功能，在其CSS官方文檔可瞭解更多相關知識。

舉例來講如何使用PostCSS，咱們使用PostCSS來爲CSS代碼自動添加適應不一樣瀏覽器的CSS前綴。

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

npm install --save-dev postcss-loader autoprefixer

接下來，在webpack配置文件中進行設置，只須要新建一個postcss關鍵字，並在裏面申明依賴的插件，以下，如今你寫的css會自動根據Can i use裏的數據添加不一樣前綴了。

//webpack配置文件 module.exports = { devtool: 'eval-source-map', entry: __dirname + "/app/main.js", output: {...}, module: { loaders: [ { test: /\.json$/, loader: "json" }, { test: /\.js$/, exclude: /node_modules/, loader: 'babel' }, { test: /\.css$/, loader: 'style!css?modules!postcss' } ] }, postcss: [ require('autoprefixer')//調用autoprefixer插件 ], devServer: {...} }

到如今，本文已經涉及處處理JS的Babel和處理CSS的PostCSS，它們其實也是兩個單獨的平臺，配合Webpack能夠很好的發揮它們的做用。接下來介紹Webpack中另外一個很是重要的功能-Plugins

插件（Plugins）

插件（Plugins）是用來拓展Webpack功能的，它們會在整個構建過程當中生效，執行相關的任務。
Loaders和Plugins經常被弄混，可是他們實際上是徹底不一樣的東西，能夠這麼來講，loaders是在打包構建過程當中用來處理源文件的（JSX，Scss，Less..），一次處理一個，插件並不直接操做單個文件，它直接對整個構建過程其做用。

Webpack有不少內置插件，同時也有不少第三方插件，可讓咱們完成更加豐富的功能。

使用插件的方法

要使用某個插件，咱們須要經過npm安裝它，而後要作的就是在webpack配置中的plugins關鍵字部分添加該插件的一個實例（plugins是一個數組）繼續看例子，咱們添加了一個實現版權聲明的插件。

//webpack.config.js var webpack = require('webpack'); module.exports = { devtool: 'eval-source-map', entry: __dirname + "/app/main.js", output: {...}, module: { loaders: [ { test: /\.json$/, loader: "json" }, { test: /\.js$/, exclude: /node_modules/, loader: 'babel' }, { test: /\.css$/, loader: 'style!css?modules!postcss' }//這裏添加PostCSS ] }, postcss: [ require('autoprefixer') ], plugins: [ new webpack.BannerPlugin("Copyright Flying Unicorns inc.")//在這個數組中new一個就能夠了 ], devServer: {...} }

經過這個插件，打包後的JS文件顯示以下


bundled JavaScript file


知道Webpack中的插件如何使用了，下面給你們推薦幾個經常使用的插件

HtmlWebpackPlugin

這個插件的做用是依據一個簡單的模板，幫你生成最終的Html5文件，這個文件中自動引用了你打包後的JS文件。每次編譯都在文件名中插入一個不一樣的哈希值。

安裝

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

這個插件自動完成了咱們以前手動作的一些事情，在正式使用以前須要對一直以來的項目結構作一些改變：

  1. 移除public文件夾，利用此插件，HTML5文件會自動生成，此外CSS已經經過前面的操做打包到JS中了，public文件夾裏。
  2. 在app目錄下，建立一個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文件夾用來存放最終的輸出文件

var webpack = require('webpack'); var HtmlWebpackPlugin = require('html-webpack-plugin'); module.exports = { devtool: 'eval-source-map', entry: __dirname + "/app/main.js", output: { path: __dirname + "/build", filename: "bundle.js" }, module: { loaders: [ { test: /\.json$/, loader: "json" }, { test: /\.js$/, exclude: /node_modules/, loader: 'babel' }, { test: /\.css$/, loader: 'style!css?modules!postcss' } ] }, postcss: [ require('autoprefixer') ], plugins: [ new HtmlWebpackPlugin({ template: __dirname + "/app/index.tmpl.html"//new 一個這個插件的實例，並傳入相關的參數 }) ], devServer: { colors: true, historyApiFallback: true, inline: true } }

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正常工做；

更新咱們的例子來實際看看如何配置

//webpack中的配置 var webpack = require('webpack'); var HtmlWebpackPlugin = require('html-webpack-plugin'); module.exports = { devtool: 'eval-source-map', entry: __dirname + "/app/main.js", output: { path: __dirname + "/build", filename: "bundle.js" }, module: { loaders: [ { test: /\.json$/, loader: "json" }, { test: /\.js$/, exclude: /node_modules/, loader: 'babel' }, { test: /\.css$/, loader: 'style!css?modules!postcss' } ] }, postcss: [ require('autoprefixer') ], plugins: [ new HtmlWebpackPlugin({ template: __dirname + "/app/index.tmpl.html" }), new webpack.HotModuleReplacementPlugin()//熱加載插件 ], devServer: { colors: true, historyApiFallback: true, inline: true, hot: true } }

安裝react-transform-hmr

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

配置Babel

{
  "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很像，以下

var webpack = require('webpack'); var HtmlWebpackPlugin = require('html-webpack-plugin'); module.exports = { entry: __dirname + "/app/main.js", output: { path: __dirname + "/build", filename: "bundle.js" }, module: { loaders: [ { test: /\.json$/, loader: "json" }, { test: /\.js$/, exclude: /node_modules/, loader: 'babel' }, { test: /\.css$/, loader: 'style!css?modules!postcss' } ] }, postcss: [ require('autoprefixer') ], plugins: [ new HtmlWebpackPlugin({ template: __dirname + "/app/index.tmpl.html" }), ], }
//package.json
{
  "name": "webpack-sample-project", "version": "1.0.0", "description": "Sample webpack project", "scripts": { "start": "webpack-dev-server --progress", "build": "NODE_ENV=production webpack --config ./webpack.production.config.js --progress" }, "author": "Cássio Zen", "license": "ISC", "devDependencies": {...}, "dependencies": {...} }

優化插件

webpack提供了一些在發佈階段很是有用的優化插件，它們大多來自於webpack社區，能夠經過npm安裝，經過如下插件能夠完成產品發佈階段所需的功能

  • OccurenceOrderPlugin :爲組件分配ID，經過這個插件webpack能夠分析和優先考慮使用最多的模塊，併爲它們分配最小的ID
  • UglifyJsPlugin：壓縮JS代碼；
  • ExtractTextPlugin：分離CSS和JS文件

咱們繼續用例子來看看如何添加它們，OccurenceOrder 和 UglifyJS plugins 都是內置插件，你須要作的只是安裝它們

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

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

var webpack = require('webpack'); var HtmlWebpackPlugin = require('html-webpack-plugin'); var ExtractTextPlugin = require('extract-text-webpack-plugin'); module.exports = { entry: __dirname + "/app/main.js", output: { path: __dirname + "/build", filename: "bundle.js" }, module: { loaders: [ { test: /\.json$/, loader: "json" }, { test: /\.js$/, exclude: /node_modules/, loader: 'babel' }, { test: /\.css$/, loader: ExtractTextPlugin.extract('style', 'css?modules!postcss') } ] }, postcss: [ require('autoprefixer') ], plugins: [ new HtmlWebpackPlugin({ template: __dirname + "/app/index.tmpl.html" }), new webpack.optimize.OccurenceOrderPlugin(), new webpack.optimize.UglifyJsPlugin(), new ExtractTextPlugin("style.css") ] }

緩存

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

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

var webpack = require('webpack'); var HtmlWebpackPlugin = require('html-webpack-plugin'); var ExtractTextPlugin = require('extract-text-webpack-plugin'); module.exports = { entry: __dirname + "/app/main.js", output: { path: __dirname + "/build", filename: "[name]-[hash].js" }, module: { loaders: [ { test: /\.json$/, loader: "json" }, { test: /\.js$/, exclude: /node_modules/, loader: 'babel' }, { test: /\.css$/, loader: ExtractTextPlugin.extract('style', 'css?modules!postcss') } ] }, postcss: [ require('autoprefixer') ], plugins: [ new HtmlWebpackPlugin({ template: __dirname + "/app/index.tmpl.html" }), new webpack.optimize.OccurenceOrderPlugin(), new webpack.optimize.UglifyJsPlugin(), new ExtractTextPlugin("[name]-[hash].css") ] }

如今用戶會有合理的緩存了。

總結

這是一篇好長的文章，謝謝你的耐心，能仔細看到了這裏，大概半個月前我第一次本身一步步配置項目所需的Webpack後就一直想寫一篇筆記作總結，幾回動筆都不能讓本身滿意，總以爲寫不清楚。直到看到本文的英文版Webpack for React，真的有屢次豁然開朗的感受，喜歡看原文的點連接就能夠看了。其實關於Webpack本文講述得仍不徹底，不過相信你看完後已經進入Webpack的大門，可以更好的探索其它的關於Webpack的知識了。

本文轉載自 http://www.jianshu.com/p/42e11515c10f  

相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程