https://www.jianshu.com/p/42e11515c10f
https://segmentfault.com/a/1190000006178770
~~~
// 一個常見的`webpack`配置文件
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-[hash].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: ExtractTextPlugin.extract({
fallback: "style-loader",
use: [{
loader: "css-loader",
options: {
modules: true,
localIdentName: '[name]__[local]--[hash:base64:5]'
}
}, {
loader: "postcss-loader"
}],
})
}
}
]
},
plugins: [
new webpack.BannerPlugin('版權所有,翻版必究'),
new HtmlWebpackPlugin({
template: __dirname + "/app/index.tmpl.html" //new 一個這個插件的實例,并傳入相關的參數
}),
new webpack.optimize.OccurrenceOrderPlugin(),
new webpack.optimize.UglifyJsPlugin(),
new ExtractTextPlugin("style.css")
]
};
~~~
### 什么是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的工作方式是:在一個配置文件中,指明對某些文件進行類似編譯,組合,壓縮等任務的具體步驟,工具之后可以自動替你完成這些任務。

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

:-: Webpack工作方式
如果實在要把二者進行比較,Webpack的處理速度更快更直接,能打包更多不同類型的文件。
### 開始使用Webpack
初步了解了Webpack工作方式后,我們一步步的開始學習使用Webpack。
#### 安裝
Webpack可以使用npm安裝,新建一個空的練習文件夾(此處命名為webpack sample project),在終端中轉到該文件夾后執行下述指令就可以完成安裝。
~~~
//全局安裝
npm install -g webpack
//安裝到你的項目目錄
npm install --save-dev webpack
~~~
#### 正式使用Webpack前的準備
1. 在上述練習文件夾中創建一個package.json文件,這是一個標準的npm說明文件,里面蘊含了豐富的信息,包括當前項目的依賴模塊,自定義的腳本任務等等。在終端中使用`npm init`命令可以自動創建這個package.json文件
~~~
npm init
~~~
輸入這個命令后,終端會問你一系列諸如項目名稱,項目描述,作者等信息,不過不用擔心,如果你不準備在npm中發布你的模塊,這些問題的答案都不重要,回車默認即可。
2. package.json文件已經就緒,我們在本項目中安裝Webpack作為依賴包
~~~
// 安裝Webpack
npm install --save-dev webpack
~~~
3. 回到之前的空文件夾,并在里面創建兩個文件夾,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非全局安裝的情況---bundle.js文件必須存在
node_modules/.bin/webpack app/main.js public/bundle.js
~~~
結果如下

使用命令行打包
可以看出`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(非全局安裝需使用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": "3.10.0"
}
}
~~~
> **注:**`package.json`中的`script`會安裝一定順序尋找命令對應位置,本地的`node_modules/.bin`路徑就在這個尋找清單中,所以無論是全局還是局部安裝的Webpack,你都不需要寫前面那指明詳細的路徑了。
npm的`start`命令是一個特殊的腳本名稱,其特殊性表現在,在命令行中使用`npm start`就可以執行其對于的命令,如果對應的此腳本名稱不是`start`,想要在命令行中運行時,需要這樣用`npm run {script name}`如`npm run build`,我們在命令行中輸入`npm start`試試,輸出結果如下:
使用npm start 打包代碼
現在只需要使用`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`是一個很好的選項,再次強調你只應該開發階段使用它,我們繼續對上文新建的`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配置選項中的一項,以下是它的一些配置選項,更多配置可參考[這里](https://link.jianshu.com?t=https://webpack.js.org/configuration/dev-server/)
| devserver的配置選項 | 功能描述 |
| --- | --- |
| 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//實時刷新
}
}
~~~
在`package.json`中的`scripts`對象中添加如下命令,用以開啟本地服務器:
~~~
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1",
"start": "webpack",
"server": "webpack-dev-server --open"
},
~~~
在終端中輸入`npm run server`即可在本地的`8080`端口查看結果
開啟本地服務器
#### Loaders
**鼎鼎大名的Loaders登場了!**
`Loaders`是`webpack`提供的最激動人心的功能之一了。通過使用不同的`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-env-preset`包和解析JSX的`babel-preset-react`包)。
我們先來一次性安裝這些依賴包
~~~
// npm一次性安裝多個依賴模塊,模塊之間用空格隔開
npm install --save-dev babel-core babel-loader babel-preset-env 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: [
"env", "react"
]
}
},
exclude: /node_modules/
}
]
}
};
~~~
現在你的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
~~~
修改`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`被正常打包了。

localhost:8080
#### 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", "env"]
}
~~~
到目前為止,我們已經知道了,對于模塊,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中進行簡單配置即可,然后就可以直接把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, // 指定啟用css modules
localIdentName: '[name]__[local]--[hash:base64:5]' // 指定css的類名格式
}
}
]
}
]
}
};
~~~
我們在app文件夾下創建一個`Greeter.css`文件來進行一下測試
~~~
/* 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}> //使用cssModule添加類名的方法
{config.greetText}
</div>
);
}
}
export default Greeter
~~~
放心使用把,相同的類名也不會造成不同組件之間的污染。
應用了css module后的樣式
CSS modules 也是一個很大的主題,有興趣的話可以去其[官方文檔](https://link.jianshu.com?t=https://github.com/css-modules/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實現更多的功能,在其[官方文檔](https://link.jianshu.com?t=https://github.com/postcss/postcss)可了解更多相關知識。
舉例來說如何使用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是一個數組)繼續上面的例子,我們添加了一個給打包后代碼[添加版權聲明的插件](https://link.jianshu.com?t=https://webpack.js.org/plugins/banner-plugin/)。
~~~
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
~~~
這個插件自動完成了我們之前手動做的一些事情,在正式使用之前需要對一直以來的項目結構做一些更改:
1. 移除public文件夾,利用此插件,`index.html`文件會自動生成,此外CSS已經通過前面的操作打包到JS中了。
2. 在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`。
build文件夾
#### 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", "env"],
"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: 'null', //注意修改了這里,這能大大壓縮我們的打包代碼
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"
}
}
~~~
> **注意:**如果是window電腦,`build`需要配置為`"build": "set NODE_ENV=production && webpack --config ./webpack.production.config.js --progress"`.謝謝評論區簡友提醒。
#### 優化插件
webpack提供了一些在發布階段非常有用的優化插件,它們大多來自于webpack社區,可以通過npm安裝,通過以下插件可以完成產品發布階段所需的功能
* `OccurenceOrderPlugin` :為組件分配ID,通過這個插件webpack可以分析和優先考慮使用最多的模塊,并為它們分配最小的ID
* `UglifyJsPlugin`:壓縮JS代碼;
* `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"
},
...
};
~~~
現在用戶會有合理的緩存了。

帶hash值的js名
#### 去除`build`文件中的殘余文件
添加了`hash`之后,會導致改變文件內容后重新打包時,文件名不同而內容越來越多,因此這里介紹另外一個很好用的插件`clean-webpack-plugin`。
**安裝**:
`cnpm install clean-webpack-plugin --save-dev`
**使用**:
引入`clean-webpack-plugin`插件后在配置文件的`plugins`中做相應配置即可:
~~~
const CleanWebpackPlugin = require("clean-webpack-plugin");
plugins: [
...// 這里是之前配置的其它各種插件
new CleanWebpackPlugin('build/*.*', {
root: __dirname,
verbose: true,
dry: false
})
]
~~~
關于`clean-webpack-plugin`的詳細使用可參考[這里](https://link.jianshu.com?t=https://github.com/johnagan/clean-webpack-plugin)
### 總結
> 其實這是一年前的文章了,趁周末重新運行和修改了一下,現在所有的代碼都可以正常運行,所用webpack基于最新的`webpack3.5.3`。希望依舊能對你有幫助。
這是一篇好長的文章,謝謝你的耐心,能仔細看到了這里,大概半個月前我第一次自己一步步配置項目所需的Webpack后就一直想寫一篇筆記做總結,幾次動筆都不能讓自己滿意,總覺得寫不清楚。其實關于Webpack本文講述得仍不完全,不過相信你看完后已經進入Webpack的大門,能夠更好的探索其它的關于Webpack的知識了。
- 前言
- CSS
- VUE
- Vue.js 安裝
- Vue.js 目錄結構
- Vue.js 起步
- Vue.js 模板語法
- Vue.js 條件與循環
- Vue.js 循環語句
- Vue.js 計算屬性
- Vue.js 監聽屬性
- Vue.js 樣式綁定
- Vue.js 事件處理器
- Vue.js 表單
- Vue.js 組件
- Vue.js 自定義指令
- Vue.js 路由
- React
- 安裝
- React JSX
- React 組件
- 問題1
- React state
- React Props
- React 組件 API
- React 組件生命周期
- React AJAX
- React 表單與事件
- React Refs
- Babel
- Ant Design
- 安裝
- 快速上手
- webpack
- 安裝
- JavaScript
- 知識點
- 字符轉數字
- js中字符串全部替換
- 函數
- reduce() 方法
- UI控件
- DataTable
- 語言配置 選項
- 增加行
- 列渲染-自定義列
- 創建行回調-操作行
- 自定義數據長度
- 默認設置
- 樣式
- 集成Bootstrap 3
- 分頁相關
- 數據
- NodeJs
- Electron
- 打包
- 介紹
- 知識點
- 使用 jquery
- CommonJS規范
- Bower
- 簡介
- 安裝
- Swing
- Swing界面組件
- JComboBox
- JDesktopPane和JInternalFrame
- JFrame
- JTabbedPane
- JTable
- JProgressBar
- JToolBar
- 知識點
- 截取log4j日志并輸出到GUI組件
- JFrame 居中顯示
- Swing中三種最大化初始窗口的方法
- Layout布局
- BorderLayout
- GridBagLayout
- GridLayout
- BoxLayout
- JxBrowser
- 瀏覽器引擎-Browser Engine
- 創建瀏覽器-Creating Browser
- 創建隱身瀏覽器-Creating Incognito Browser
- 存儲用戶數據-Storing User Data
- 處理瀏覽器-Disposing Browser
- 瀏覽器偏好-Browser Preferences
- 恢復瀏覽器-Restoring Browser
- 渲染流程事件-Render Process Events
- 渲染進程ID-Render Process ID
- 獲取幀ID-Getting Frame IDs
- 獲取產品版本-Getting Product Version
- 尋找文本-Finding Text
- 清除緩存-Clearing Cache
- 轉發鍵盤事件-Forwarding Key Events
- 轉發鼠標事件-Forwarding Mouse Events
- 加載內容-Loading Content
- 加載網址-Loading URL
- 使用POST加載URL-Loading URL with POST
- 加載HTML-Loading HTML
- 從JAR加載HTML-Loading HTML from JAR
- 獲取HTML-Getting HTML
- 獲取選定的HTML-Getting Selected HTML
- 加載事件-Loading Events
- 正在加載和等待-Loading & Waiting
- 顯示PDF-Displaying PDF
- 網絡活動-Network Events
- 處理資源加載-Handling Resources Loading
- 啟用/禁用退格導航-Enabling/Disabling Backspace Navigation
- 處理SSL證書錯誤-Handling SSL Certificate Errors
- SSL證書驗證程序-SSL Certificate Verifier
- 導航歷史-Navigation History
- User-Agent
- WebSockets
- 處理加載-Handling Loading
- 修改POST / PUT / PATCH上傳數據-Modifying POST/PUT/PATCH Upload Data
- HTML5本地和會話存儲-HTML5 Local & Session storages
- 訪問HTTP響應數據-Accessing HTTP response data
- HTTP服務器白名單-HTTP Server Whitelist
- 自定義協議處理程序-Custom Protocol Handler
- ActiveX
- 瀏覽器視圖-Browser View
- 輕量級或重量級-Lightweight or Heavyweight
- 在Swing中使用JxBrowser-Using JxBrowser in Swing
- 在JavaFX中使用JxBrowser-Using JxBrowser in JavaFX
- 在SWT中使用JxBrowser-Using JxBrowser in SWT
- 自定義CSS光標-Custom CSS Cursors
- 標題事件-Title Events
- 狀態事件-Status Events
- 鍵盤和鼠標事件-Keyboard & Mouse Events
- 處理鍵盤事件-Handling Keyboard Events
- 處理鼠標事件-Handling Mouse Events
- 編輯器命令-Editor Commands
- 拖放-Drag & Drop
- 內容縮放-Content scaling
- 上下文菜單-Context Menu
- JMenuBar
- JInternalFrame
- JTabbedPane
- JPanel
- 加速輕量級渲染-Accelerated Lightweight Rendering
- 透明背景-Transparent Background
- DOM
- 使用文檔-Working with Document
- 注入css-Injecting CSS
- 尋找元素-Finding Elements
- 元素屬性-Element Attributes
- 創建元素和文本節點-Creating Element & Text Node
- 設置節點值-Setting Node Value
- Select & Option Elements
- 選擇CheckBox-Selecting CheckBox
- Getting Selected Text
- 模擬點擊-Simulating Click
- DOM事件
- XPath
- 查詢選擇器-Query Selector
- 使用表單-Working with Form
- 滾動文檔-Scrolling Document
- 在Point處查找節點-Finding Node at Point
- 獲得元素界限-Getting Element Bounds
- 監聽內容變化-Listening to the Сontent Сhanges
- 模擬DOM事件-Simulating DOM Events
- Audio & Video
- MP3/MP4/H.264
- 網絡攝像頭和麥克風-Web Camera & Microphone
- 全屏視頻-Full Screen Video
- 靜音音頻-Muting Audio
- HTML5 Video
- Pop-ups
- 關于彈出窗口-About Pop-ups
- 在swing中處理彈出窗口-Handling Pop-ups Swing
- 在JavaFX中處理彈出窗口-Handling Pop-ups JavaFX
- Dialogs
- JavaScript對話框-JavaScript Dialogs
- 文件下載-File Download
- 上傳文件-File Upload
- 選擇SSL證書-Select SSL Certificate
- 選擇自定義SSL證書-Select Custom SSL Certificate
- 卸載前-Before Unload
- 顏色選擇器-Color Chooser
- Proxy
- 使用代理-Working with Proxy
- 系統代理設置-System Proxy Settings
- Authentication
- 處理代理驗證-Handling Proxy Authentication
- 處理基本,摘要和NTLM身份驗證-Handling Basic, Digest and NTLM Authentication
- JavaScript Java Bridge
- 從Java調用JavaScript-Calling JavaScript from Java
- 從JavaScript調用Java-Calling Java from JavaScript
- 控制臺消息-Console Messages
- 使用JSON-Working with JSON
- 使用jQuery-Working with jQuery
- 使用ScriptContext-Working with ScriptContext
- 將表單數據發送到Java-Sending Form Data to Java
- 使用數組-Working with Arrays
- @JSAccessible
- Plugins
- Printing
- Cookies
- Saving Web Page
- Zoom
- Integration
- Deploying
- Chromium
- Spell Checker
- Debugging
- Why JxBrowser
- Tips & Tricks
- 基礎知識
- AbstractAction
- Void
- SwingWorker應用詳解
- JAVA實現國際化
- UIManager
- AppJS
- heX
- bootstrap
- 知識點
- 空行
- Eclipse RCP
- Eclipse e4 概覽