2017年12月7日更新，添加了
clean-webpack-plugin,
babel-env-preset,添加本文涉及到的所有代码的示例，如果你在学习过程中出错了，可点击此处参考
写在前面的话
阅读本文之前，先看下面这个webpack的配置文件，如果每一项你都懂，那本文能带给你的收获也许就比较有限，你可以快速浏览或直接跳过；如果你和十天前的我一样，对很多选项存在着疑惑，那花一段时间慢慢阅读本文，你的疑惑一定一个一个都会消失；如果你以前没怎么接触过Webpack，而你又你对webpack感兴趣，那么动手跟着本文中那个贯穿始终的例子写一次，写完以后你会发现你已明明白白的走进了Webpack的大门。
// 一个常见的`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的工作方式是：在一个配置文件中，指明对某些文件进行类似编译，组合，压缩等任务的具体步骤，工具之后可以自动替你完成这些任务。
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文件命名为
，之后我们还会详细讲述）。
<!-- 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>
我们在
中定义一个返回包含问候信息的
元素的函数,并依据CommonJS规范导出这个函数为一个模块：
// Greeter.js
module.exports = function() {
var greet = document.createElement('div');
greet.textContent = "Hi there and greetings!";
return greet;
};
文件中我们写入下述代码，用以把
返回的节点插入页面。
//main.js
const greeter = require('./Greeter.js');
document.querySelector("#root").appendChild(greeter());
正式使用Webpack
webpack可以在终端中使用，在基本的使用方法如下：
<span class="hljs-comment"># {extry file}出填写入口文件的路径，本文中就是上述main.js的路径，</span>
<span class="hljs-comment"># {destination for bundled file}处填写打包文件的存放路径</span>
<span class="hljs-comment"># 填写路径的时候不用添加{}</span>
webpack {entry file} {destination <span class="hljs-keyword">for</span> bundled file}
指定入口文件后，webpack将自动识别项目所依赖的其它文件，不过需要注意的是如果你的webpack不是全局安装的，那么当你在终端中使用此命令时，需要额外指定其在node_modules中的地址，继续上面的例子，在终端中输入如下命令
<span class="hljs-comment"># webpack非全局安装的情况</span>
node_modules/.bin/webpack app/main.js public/bundle.js
结果如下
可以看出
同时编译了
和
,现在打开
,可以看到如下结果
有没有很激动，已经成功的使用
打包了一个文件了。不过在终端中进行复杂的操作，其实是不太方便且容易出错的，接下来看看Webpack的另一种更常见的使用方法。
通过配置文件来使用
Webpack
Webpack拥有很多其它的比较高级的功能（比如说本文后面会介绍的
和
），这些功能其实都可以通过命令行模式实现，但是正如前面提到的，这样不太方便且容易出错的，更好的办法是定义一个配置文件，这个配置文件其实也是一个简单的JavaScript模块，我们可以把所有的与打包相关的信息放在里面。
继续上面的例子来说明如何写这个配置文件，在当前练习文件夹的根目录下新建一个名为
的文件，我们在其中写入如下所示的简单配置代码，目前的配置主要涉及到的内容是入口文件路径和打包后文件的存放路径。
module.exports = {
entry: __dirname + "/app/main.js",//已多次提及的唯一入口文件
output: {
path: __dirname + "/public",//打包后的文件存放的地方
filename: "bundle.js"//打包后输出文件的文件名
}
}
注：“__dirname”是node.js中的一个全局变量，它指向当前执行脚本所在的目录。
有了这个配置之后，再打包文件，只需在终端里运行
命令就可以了，这条命令会自动引用
文件中的配置选项，示例如下：
又学会了一种使用
的方法，这种方法不用管那烦人的命令行参数，有没有感觉很爽。如果我们可以连
这条命令都可以不用，那种感觉会不会更爽~，继续看下文。
更快捷的执行打包任务
在命令行中输入命令需要代码类似于
这样的路径其实是比较烦人的，不过值得庆幸的是
可以引导任务执行，对
进行配置后可以在命令行中使用简单的
命令来替代上面略微繁琐的命令。在
中对
对象进行相关设置即可，设置方法如下。
{
<span class="hljs-attr">"name"</span>: <span class="hljs-string">"webpack-sample-project"</span>,
<span class="hljs-attr">"version"</span>: <span class="hljs-string">"1.0.0"</span>,
<span class="hljs-attr">"description"</span>: <span class="hljs-string">"Sample webpack project"</span>,
<span class="hljs-attr">"scripts"</span>: {
<span class="hljs-attr">"start"</span>: <span class="hljs-string">"webpack"</span> // 修改的是这里，JSON文件不支持注释，引用时请清除
},
<span class="hljs-attr">"author"</span>: <span class="hljs-string">"zhang"</span>,
<span class="hljs-attr">"license"</span>: <span class="hljs-string">"ISC"</span>,
<span class="hljs-attr">"devDependencies"</span>: {
<span class="hljs-attr">"webpack"</span>: <span class="hljs-string">"3.10.0"</span>
}
}
注：
package.json中的
script会安装一定顺序寻找命令对应位置，本地的
node_modules/.bin路径就在这个寻找清单中，所以无论是全局还是局部安装的Webpack，你都不需要写前面那指明详细的路径了。
npm的
命令是一个特殊的脚本名称，其特殊性表现在，在命令行中使用
就可以执行其对于的命令，如果对应的此脚本名称不是
，想要在命令行中运行时，需要这样用
如
，我们在命令行中输入
试试，输出结果如下：
现在只需要使用
就可以打包文件了，有没有觉得
也不过如此嘛，不过不要太小瞧
，要充分发挥其强大的功能我们需要修改配置文件的其它选项，一项项来看。
Webpack的强大功能
生成Source Maps（使调试更容易）
开发总是离不开调试，方便的调试能极大的提高开发效率，不过有时候通过打包后的文件，你是不容易找到出错了的地方，对应的你写的代码的位置的，
就是来帮我们解决这个问题的。
通过简单的配置，
就可以在打包时为我们生成的
，这为我们提供了一种对应编译文件和源文件的方法，使得编译后的代码可读性更高，也更容易调试。
在
的配置文件中配置
，需要配置
，它有以下四种不同的配置选项，各具优缺点，描述如下：
| 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 选项具有相似的缺点； |
正如上表所述，上述选项由上到下打包速度越来越快，不过同时也具有越来越多的负面作用，较快的打包速度的后果就是对打包后的文件的的执行有一定影响。
对小到中型的项目中，
是一个很好的选项，再次强调你只应该开发阶段使用它，我们继续对上文新建的
，进行如下配置:
module.exports = {
devtool: 'eval-source-map',
entry: __dirname + "/app/main.js",
output: {
path: __dirname + "/public",
filename: "bundle.js"
}
}
cheap-module-eval-source-map方法构建速度更快，但是不利于调试，推荐在大型项目考虑时间成本时使用。
使用webpack构建本地服务器
想不想让你的浏览器监听你的代码的修改，并自动刷新显示修改后的结果，其实
提供一个可选的本地开发服务器，这个本地服务器基于node.js构建，可以实现你想要的这些功能，不过它是一个单独的组件，在webpack中进行配置之前需要单独安装它作为项目依赖
npm install --save-dev webpack-dev-server
devserver作为webpack配置选项中的一项，以下是它的一些配置选项，更多配置可参考这里
| devserver的配置选项 | 功能描述 |
|---|---|
| contentBase | 默认webpack-dev-server会为根文件夹提供本地服务器，如果想为另外一个目录下的文件提供本地服务器，应该在这里设置其所在目录（本例设置到“public"目录） |
| port | 设置默认监听端口，如果省略，默认为”8080“ |
| inline | 设置为
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",//本地服务器所加载的页面所在的目录
historyApiFallback: true,//不跳转
inline: true//实时刷新
}
}
在
中的
对象中添加如下命令，用以开启本地服务器：
<span class="hljs-string">"scripts"</span>: {
<span class="hljs-attr">"test"</span>: <span class="hljs-string">"echo "Error: no test specified" && exit 1"</span>,
<span class="hljs-attr">"start"</span>: <span class="hljs-string">"webpack"</span>,
<span class="hljs-attr">"server"</span>: <span class="hljs-string">"webpack-dev-server --open"</span>
},
在终端中输入
即可在本地的
端口查看结果
Loaders
鼎鼎大名的Loaders登场了！
是
提供的最激动人心的功能之一了。通过使用不同的
，
有能力调用外部的脚本或工具，实现对不同格式的文件的处理，比如说分析转换scss为css，或者把下一代的JS文件（ES6，ES7)转换为现代浏览器兼容的JS文件，对React的开发而言，合适的Loaders可以把React的中用到的JSX文件转换为JS文件。
Loaders需要单独安装并且需要在
中的
关键字下进行配置，Loaders的配置包括以下几方面：
-
test
：一个用以匹配loaders所处理文件的拓展名的正则表达式（必须）
-
loader
：loader的名称（必须）
-
include/exclude
:手动添加必须处理的文件（文件夹）或屏蔽不需要处理的文件（文件夹）（可选）；
-
query
：为loaders提供额外的设置选项（可选）
不过在配置loader之前，我们把
里的问候消息放在一个单独的JSON文件里,并通过合适的配置使
可以读取该JSON文件的值，各文件修改后的代码如下：
在app文件夹中创建带有问候信息的JSON文件(命名为
)
{
<span class="hljs-attr">"greetText"</span>: <span class="hljs-string">"Hi there and greetings from JSON!"</span>
}
更新后的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其实是几个模块化的包，其核心功能位于称为
的npm包中，webpack可以把其不同的包整合在一起使用，对于每一个你需要的功能或拓展，你都需要安装单独的包（用得最多的是解析Es6的
包和解析JSX的
包）。
我们先来一次性安装这些依赖包
// npm一次性安装多个依赖模块，模块之间用空格隔开
npm install --save-dev babel-core babel-loader babel-preset-env babel-preset-react
在
中配置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的语法，更新
并返回一个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模块
// main.js
import React from 'react';
import {render} from 'react-dom';
import Greeter from './Greeter';
render(<Greeter />, document.getElementById('root'));
重新使用
打包，如果之前打开的本地服务器没有关闭，你应该可以在
下看到与之前一样的内容，这说明
和
被正常打包了。
Babel的配置
Babel其实可以完全在
中进行配置，但是考虑到babel具有非常多的配置选项，在单一的
文件中进行配置往往使得这个文件显得太复杂，因此一些开发者支持把babel的配置选项放在一个单独的名为 ".babelrc" 的配置文件中。我们现在的babel的配置并不算复杂，不过之后我们会再加一些东西，因此现在我们就提取出相关部分，分两个配置文件进行配置（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"
},
exclude: /node_modules/
}
]
}
};
//.babelrc
{
"presets": ["react", "env"]
}
到目前为止，我们已经知道了，对于模块，Webpack能提供非常强大的处理功能，那那些是模块呢。
一切皆模块
Webpack有一个不可不说的优点，它把所有的文件都都当做模块处理，JavaScript代码，CSS和fonts以及图片等等通过合适的loader都可以被处理。
CSS
webpack提供两个工具处理样式表，
和
，二者处理的任务不同，
使你能够使用类似
和
的方法实现
的功能,
将所有的计算后的样式加入页面中，二者组合在一起使你能够把样式表嵌入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"的文件，对一些元素设置样式
<span class="hljs-comment">/* main.css */</span>
<span class="hljs-selector-tag">html</span> {
<span class="hljs-attribute">box-sizing</span>: border-box;
<span class="hljs-attribute">-ms-text-size-adjust</span>: <span class="hljs-number">100%</span>;
<span class="hljs-attribute">-webkit-text-size-adjust</span>: <span class="hljs-number">100%</span>;
}
*, *<span class="hljs-selector-pseudo">:before</span>, *<span class="hljs-selector-pseudo">:after</span> {
<span class="hljs-attribute">box-sizing</span>: inherit;
}
<span class="hljs-selector-tag">body</span> {
<span class="hljs-attribute">margin</span>: <span class="hljs-number">0</span>;
<span class="hljs-attribute">font-family</span>: <span class="hljs-string">'Helvetica Neue'</span>, Helvetica, Arial, sans-serif;
}
<span class="hljs-selector-tag">h1</span>, <span class="hljs-selector-tag">h2</span>, <span class="hljs-selector-tag">h3</span>, <span class="hljs-selector-tag">h4</span>, <span class="hljs-selector-tag">h5</span>, <span class="hljs-selector-tag">h6</span>, <span class="hljs-selector-tag">p</span>, <span class="hljs-selector-tag">ul</span> {
<span class="hljs-attribute">margin</span>: <span class="hljs-number">0</span>;
<span class="hljs-attribute">padding</span>: <span class="hljs-number">0</span>;
}
我们这里例子中用到的
只有单一的入口，其它的模块需要通过
,
,
等与入口文件建立其关联，为了让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发展就相对慢一些，大多的样式表却依旧巨大且充满了全局类名，维护和修改都非常困难。
被称为
的技术意在把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 */
.root {
background-color: #eee;
padding: 10px;
border: 3px solid #ccc;
}
导入
到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 modules 也是一个很大的主题，有兴趣的话可以去其官方文档了解更多。
CSS预处理器
和
之类的预处理器是对原生CSS的拓展，它们允许你使用类似于
,
,
,
等不存在于CSS中的特性来写CSS，CSS预处理器可以这些特殊类型的语句转化为浏览器可识别的CSS语句，
你现在可能都已经熟悉了，在webpack里使用相关loaders进行配置就可以使用了，以下是常用的CSS 处理
:
-
Less Loader
-
Sass Loader
-
Stylus Loader
不过其实也存在一个CSS的处理平台
，它可以帮助你的CSS实现更多的功能，在其官方文档可了解更多相关知识。
举例来说如何使用PostCSS，我们使用PostCSS来为CSS代码自动添加适应不同浏览器的CSS前缀。
首先安装
和
（自动添加前缀的插件）
npm install --save-dev postcss-loader autoprefixer
接下来，在webpack配置文件中添加
，在根目录新建
,并添加如下代码之后，重新使用
打包时，你写的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中另一个非常重要的功能-
插件（Plugins）
插件（Plugins）是用来拓展Webpack功能的，它们会在整个构建过程中生效，执行相关的任务。
Loaders和Plugins常常被弄混，但是他们其实是完全不同的东西，可以这么来说，loaders是在打包构建过程中用来处理源文件的（JSX，Scss，Less..），一次处理一个，插件并不直接操作单个文件，它直接对整个构建过程其作用。
Webpack有很多内置插件，同时也有很多第三方插件，可以让我们完成更加丰富的功能。
使用插件的方法
要使用某个插件，我们需要通过
安装它，然后要做的就是在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
这个插件的作用是依据一个简单的
模板，生成一个自动引用你打包后的JS文件的新
。这在每次生成的js文件名称不同时非常有用（比如添加了
值）。
安装
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.更新
的配置文件，方法同上,新建一个
文件夹用来存放最终的输出文件
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 一个这个插件的实例，并传入相关的参数
})
],
};
再次执行
你会发现，build文件夹下面生成了
和
。
Hot Module Replacement
（HMR）也是webpack里很有用的一个插件，它允许你在修改组件代码后，自动刷新实时预览修改后的效果。
在webpack中实现HMR也很简单，只需要做两项配置
- 在webpack配置文件中添加HMR插件；
- 在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()//热加载插件
],
};
安装
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.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")
],
};
此时执行
可以看见代码是被压缩后的
缓存
缓存无处不在，使用缓存的最好方法是保证你的文件名和文件内容是匹配的（内容改变，名称相应改变）
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"
},
...
};
现在用户会有合理的缓存了。
去除
build
文件中的残余文件
添加了
之后，会导致改变文件内容后重新打包时，文件名不同而内容越来越多，因此这里介绍另外一个很好用的插件
。
安装：
使用：
引入
插件后在配置文件的
中做相应配置即可：
const CleanWebpackPlugin = require("clean-webpack-plugin");
plugins: [
...// 这里是之前配置的其它各种插件
new CleanWebpackPlugin('build/*.*', {
root: __dirname,
verbose: true,
dry: false
})
]
关于
的详细使用可参考这里
总结
其实这是一年前的文章了，趁周末重新运行和修改了一下，现在所有的代码都可以正常运行，所用webpack基于最新的
webpack3.5.3。希望依旧能对你有帮助。
这是一篇好长的文章，谢谢你的耐心，能仔细看到了这里，大概半个月前我第一次自己一步步配置项目所需的Webpack后就一直想写一篇笔记做总结，几次动笔都不能让自己满意，总觉得写不清楚。其实关于Webpack本文讲述得仍不完全，不过相信你看完后已经进入Webpack的大门，能够更好的探索其它的关于Webpack的知识了。
欢迎大家在文后发表自己的观点讨论。
作者：zhangwang 链接：https://www.jianshu.com/p/42e11515c10f 前面部分为入门阶段。 后文为进阶阶段
这篇文章将介绍如何利用 webpack 进行单页面应用的开发，算是我在实际开发中的一些心得和体会,在这里给大家做一个分享。webpack 的介绍这里就不多说了，可以直接去官网查看。 关于这个单页面应用大家可以直接去我的github上查看https://github.com/huangshuwei/webpackForSPA，我将结合这个项目去介绍。如果大家觉得这篇文章有不妥的地方，还请指出。
这篇文章的目的是解决我们在开发中会遇到的问题，不是一篇基础教程，还请谅解。
项目目录
我将根据这个目录结构进行讲解
- dist：发布的文件目录，即webpack编译输出的目录
- libs：放置公共的文件，如js、css、img、font等
- mockServer：模拟后端服务，即用webpack开发时模拟调用的后端服务（用nodejs服务模拟）
- node_modules：项目依赖的包
- src：资源文件，里面包含css、font、html、img、js
- package.json：项目配置
- webpack.config.js：webpack的配置文件
项目的使用
建议先运行一下这个项目，有一个大致的了解，再往下阅读。使用说明：
首先克隆一份到你的本地
$ git <span class="hljs-keyword">clone</span> <span class="hljs-title">https</span>://github.com/huangshuwei/webpackForSPA.git
然后 cd 到 ‘webpackForSPA’目录下
$ cd webpackForSPA
接着你可以运行不同的命令查看结果
发布模式：
$ npm run build
开发模式：
$ npm run dev
热更新模式
$ npm run dev-hrm
如果使用了热更新模式，并且想要结合后端服务形式运行，那么cd 到‘mockServer’目录下，并执行<span class="hljs-keyword">node</span> <span class="hljs-title">服务：
$</span> cd mockServer
$ <span class="hljs-keyword">node</span> <span class="hljs-title">server</span>.js
区分开发、热更新、发布模式
一般开发时和发布时是不同的，比如开发时文件的访问目录包含‘dist’目录，但是发布上线时，一般会把‘dist’文件夹去掉。
当然还有其他的一些细节不同。
开发模式：
- 能看到webpack编译输出的文件
- js、css、html文件不需要压缩
- 可以正确的运行编译输出后的文件
- 这种模式一般只是用来看webpack编译输出后的文件是否正确
热更新模式：
- 看不到webpack编译输出的文件
- js、css、html文件不需要压缩
- 更改完文件后无需重新编译并自动刷新浏览器
- 可以结合后端服务开发，避过浏览器同源策略，如结合java、.net服务等
发布模式：
- 能看到webpack编译输出的文件
- js、css、html文件压缩
- 文件的层级目录不需要包含‘dist’目录
我区分开发、热更新、发布模式是通过配置‘package.json’文件的运行命令，有些人是通过创建多个不同的webpack的配置文件来达到想要的效果。
像这个项目就是使用了多个webpack的配置文件。
配置命令
这是在 package.json 文件中配置的
<span class="hljs-comment">//</span> <span class="hljs-comment">package</span><span class="hljs-string">.</span><span class="hljs-comment">json</span> <span class="hljs-comment">文件</span>
<span class="hljs-string">.</span><span class="hljs-string">.</span><span class="hljs-string">.</span>
<span class="hljs-comment">"scripts":</span> <span class="hljs-comment">{</span>
<span class="hljs-comment">"build":</span> <span class="hljs-comment">"webpack</span> <span class="hljs-literal">-</span><span class="hljs-literal">-</span><span class="hljs-comment">profile</span> <span class="hljs-literal">-</span><span class="hljs-literal">-</span><span class="hljs-comment">progress</span> <span class="hljs-literal">-</span><span class="hljs-literal">-</span><span class="hljs-comment">colors</span> <span class="hljs-literal">-</span><span class="hljs-literal">-</span><span class="hljs-comment">display</span><span class="hljs-literal">-</span><span class="hljs-comment">error</span><span class="hljs-literal">-</span><span class="hljs-comment">details"</span><span class="hljs-string">,</span>
<span class="hljs-comment">"dev":</span> <span class="hljs-comment">"webpack</span> <span class="hljs-literal">-</span><span class="hljs-literal">-</span><span class="hljs-comment">display</span><span class="hljs-literal">-</span><span class="hljs-comment">modules</span> <span class="hljs-literal">-</span><span class="hljs-literal">-</span><span class="hljs-comment">profile</span> <span class="hljs-literal">-</span><span class="hljs-literal">-</span><span class="hljs-comment">progress</span> <span class="hljs-literal">-</span><span class="hljs-literal">-</span><span class="hljs-comment">colors</span> <span class="hljs-literal">-</span><span class="hljs-literal">-</span><span class="hljs-comment">display</span><span class="hljs-literal">-</span><span class="hljs-comment">error</span><span class="hljs-literal">-</span><span class="hljs-comment">details"</span><span class="hljs-string">,</span>
<span class="hljs-comment">"dev</span><span class="hljs-literal">-</span><span class="hljs-comment">hrm":</span> <span class="hljs-comment">"webpack</span><span class="hljs-literal">-</span><span class="hljs-comment">dev</span><span class="hljs-literal">-</span><span class="hljs-comment">server</span> <span class="hljs-literal">-</span><span class="hljs-literal">-</span><span class="hljs-comment">config"</span>
<span class="hljs-comment">}</span><span class="hljs-string">,</span>
<span class="hljs-string">.</span><span class="hljs-string">.</span><span class="hljs-string">.</span>
- color 输出结果带彩色，比如：会用红色显示耗时较长的步骤
- profile 输出性能数据，可以看到每一步的耗时
- progress 输出当前编译的进度，以百分比的形式呈现
- display-modules 默认情况下 node_modules 下的模块会被隐藏，加上这个参数可以显示这些被隐藏的模块
- display-error-details 输出详细的错误信息
- webpack-dev-server 将会开启热更新
- 更多请参考官网 cli
配置好了package.json文件,我们就可以这样运行
// 开发模式
npm <span class="hljs-keyword">run</span><span class="bash"> dev
</span>
// 热更新模式
npm <span class="hljs-keyword">run</span><span class="bash"> dev-hrm
</span>
// 发布模式
npm <span class="hljs-keyword">run</span><span class="bash"> build</span>
配置变量标识
配置完了命令，当我们运行不同的命令时，我们可以通过‘process.env.npm_lifecycle_event’去获取当前运行的命令，根据不同的命令，我们可以按照自己的需要做相应的处理。比如开发模式时，允许开启调试，静态资源不要压缩；发布模式时，不允许调试，静态资源要压缩。具体如下：
// webpack.config.js
// 获取当前运行的模式
var <span class="hljs-attr">currentTarget</span> = process.env.npm_lifecycle_event;
var debug, // 是否是调试
devServer, // 是否是热更新模式
minimize; // 是否需要压缩
<span class="hljs-keyword">if</span> (<span class="hljs-attr">currentTarget</span> == <span class="hljs-string">"build"</span>) { // 发布模式
<span class="hljs-attr">debug</span> = <span class="hljs-literal">false</span>, <span class="hljs-attr">devServer</span> = <span class="hljs-literal">false</span>, <span class="hljs-attr">minimize</span> = <span class="hljs-literal">true</span>;
} <span class="hljs-keyword">else</span> <span class="hljs-keyword">if</span> (<span class="hljs-attr">currentTarget</span> == <span class="hljs-string">"dev"</span>) { // 开发模式
<span class="hljs-attr">debug</span> = <span class="hljs-literal">true</span>, <span class="hljs-attr">devServer</span> = <span class="hljs-literal">false</span>, <span class="hljs-attr">minimize</span> = <span class="hljs-literal">false</span>;
} <span class="hljs-keyword">else</span> <span class="hljs-keyword">if</span> (<span class="hljs-attr">currentTarget</span> == <span class="hljs-string">"dev-hrm"</span>) { // 热更新模式
<span class="hljs-attr">debug</span> = <span class="hljs-literal">true</span>, <span class="hljs-attr">devServer</span> = <span class="hljs-literal">true</span>, <span class="hljs-attr">minimize</span> = <span class="hljs-literal">false</span>;
}
基础配置
配置路径
为了方便我们频繁使用路径，如下配置
<span class="hljs-comment">// webpack.config.js</span>
var PATHS = {
<span class="hljs-comment">// 发布目录</span>
publicPath: debug ? <span class="hljs-string">'/webpackForSPA/dist/'</span> : <span class="hljs-string">'/webpackForSPA/'</span>,
<span class="hljs-comment">// 公共资源目录</span>
libsPath: path.resolve(<span class="hljs-built_in">process</span>.cwd(), <span class="hljs-string">'./libs'</span>),
<span class="hljs-comment">// src 资源目录</span>
srcPath: path.resolve(<span class="hljs-built_in">process</span>.cwd(), <span class="hljs-string">'src'</span>),
}
配置别名
webpack的别名的目的就是简化我们的操作，引用资源时直接使用别名即可（和 seajs 里的别名用法一样）。配置如下：
<span class="hljs-comment">// webpack.config.js</span>
...
resolve:{
alias: {
<span class="hljs-comment">// js</span>
jquery: path.join(PATHS<span class="hljs-selector-class">.libsPath</span>, <span class="hljs-string">"js/jquery/jquery"</span>),
underscore: path.join(PATHS<span class="hljs-selector-class">.libsPath</span>, <span class="hljs-string">"js/underscore/underscore.js"</span>),
<span class="hljs-comment">// css</span>
bootstrapcss: path.join(PATHS<span class="hljs-selector-class">.libsPath</span>, <span class="hljs-string">"css/bootstrap/bootstrap-3.3.5.css"</span>),
indexcss: path.join(PATHS<span class="hljs-selector-class">.srcPath</span>, <span class="hljs-string">"css/index.css"</span>),
}
}
...
配置webpack编译入口
<span class="hljs-comment">// webpack.config.js</span>
...
entry:{
<span class="hljs-comment">// 入口 js</span>
index: <span class="hljs-string">'./src/js/index.js'</span>,
<span class="hljs-comment">// 公共js包含的文件</span>
common: [
path.join(PATHS<span class="hljs-selector-class">.libsPath</span>, <span class="hljs-string">"js/jquery/jquery.js"</span>),
path.join(PATHS<span class="hljs-selector-class">.libsPath</span>, <span class="hljs-string">"js/underscore/underscore.js"</span>)
],
}
...
配置webpack编译输出
<span class="hljs-comment">// webpack.config.js</span>
...
<span class="hljs-selector-tag">output</span>：{
<span class="hljs-comment">// 输出目录</span>
<span class="hljs-attribute">path</span>: path.join(__dirname, <span class="hljs-string">'dist'</span>),
<span class="hljs-comment">// 发布后，资源的引用目录</span>
<span class="hljs-attribute">publicPath</span>: PATHS.publicPath,
<span class="hljs-comment">// 文件名称</span>
<span class="hljs-attribute">filename</span>: <span class="hljs-string">'js/[name].js'</span>,
<span class="hljs-comment">// 按需加载模块时输出的文件名称</span>
<span class="hljs-attribute">chunkFilename</span>: <span class="hljs-string">'js/[name].js'</span>
}
...
提取css到单独的文件
当我们在js文件中通过require('')引用js时，webpack 默认会将css文件与当前js文件打包一起，但是这种方式会阻塞页面的加载，因为css的执行要等待js文件加载进来。所以我们会把css从js文件中提取出来，放到一个单独的css文件中。这时我们要使用webpack的插件：extract-text-webpack-plugin，配置如下：
引入插件
<span class="hljs-comment">// webpack.config.js</span>
<span class="hljs-keyword">var</span> ExtractTextPlugin = <span class="hljs-built_in">require</span>(<span class="hljs-string">"extract-text-webpack-plugin"</span>);
配置 loader
<span class="hljs-comment">// webpack.config.js</span>
...
loaders: [
{
test: /\.css$/,
loader: ExtractTextPlugin.extract(<span class="hljs-string">"style-loader"</span>, <span class="hljs-string">"css-loader!postcss-loader"</span>)
},
...
]
...
配置 plugins
<span class="hljs-comment">// webpack.config.js</span>
...
<span class="hljs-string">plugins:</span>[
<span class="hljs-keyword">new</span> ExtractTextPlugin(<span class="hljs-string">"css/[name].css"</span>, {<span class="hljs-string">allChunks:</span> <span class="hljs-literal">true</span>}),
...
]
...
公共js打包
项目中，我们通常会有公共的js，比如 jquery、bootstrap、underscore 等，那么这时候我们需要将这些公共的js单独打包。这时我们需要用webpack自带的插件：
<span class="hljs-comment">// webpack.config.js</span>
...
plugins:[
<span class="hljs-comment">// 会把 ‘entry’ 定义的 common 对应的两个js 打包为 ‘common.js’</span>
new webpack<span class="hljs-selector-class">.optimize</span><span class="hljs-selector-class">.CommonsChunkPlugin</span>(<span class="hljs-string">"common"</span>, <span class="hljs-string">'js/[name].js'</span>, Infinity),
]
...
资源添加版本号
项目上线后，资源的版本号十分重要。资源没有版本号，即使重新发布，客户端浏览器可能会把老的资源缓存下来，导致无法下载最新的资源。webpack 支持给资源添加版本号，不仅仅是js、css,甚至font、img都可以添加版本号。我们可以通过webpack中的‘chunkhash’来解决。
首先要了解下webpack 中 [hash]、[chunkhash]、[chunkhash:8]的区别。
- [hash]：webpack编译会产生一个hash值
- [chunkhash]：每个模块的hash值
- [chunkhash:8]：取[chunkhash]的前8位
推荐发布模式使用版本号，其他模式无需使用，热更新模式不支持‘chunkhash’，但是支持‘hash’
资源加版本号，那么我们的输出的部分都要做改动，并且要区分当前的命令模式，如下：
<span class="hljs-comment">// webpack.config.js</span>
...
<span class="hljs-selector-tag">output</span>：{
<span class="hljs-comment">// 输出目录</span>
<span class="hljs-attribute">path</span>: path.join(__dirname, <span class="hljs-string">'dist'</span>),
<span class="hljs-comment">// 发布后，资源的引用目录</span>
<span class="hljs-attribute">publicPath</span>: PATHS.publicPath,
<span class="hljs-comment">// 文件名称</span>
<span class="hljs-attribute">filename</span>: devServer ? <span class="hljs-string">'js/[name].js'</span> : <span class="hljs-string">'js/[name]-[chunkhash:8].js'</span>,
<span class="hljs-comment">// 按需加载模块时输出的文件名称</span>
<span class="hljs-attribute">chunkFilename</span>: devServer ? <span class="hljs-string">'js/[name].js'</span> : <span class="hljs-string">'js/[name]-[chunkhash:8].js'</span>
}
...
输出公共js的地方也要改动：
<span class="hljs-comment">// webpack.config.js</span>
...
plugins:[
<span class="hljs-comment">// 会把 ‘entry’ 定义的 common 对应的两个js 打包为 ‘common.js’</span>
new webpack.optimize.CommonsChunkPlugin(<span class="hljs-string">"common"</span>, <span class="hljs-string">""</span> + (devServer ? <span class="hljs-string">'js/[name].js'</span> : <span class="hljs-string">"js/[name]-[chunkhash:8].js"</span>), Infinity),
]
...
页面自动引入含有版本号的文件
有个版本号后，我们考虑如何通过html引用这些含有版本号的js、css、font、img。webpack每次编译后的资源 chunkhash 会随着内容的变化而变化，所以我们不可能每次都手动的更改html这些资源的引用路径。这时我们要用到webpack的插件：html-webpack-plugin。这个插件的目的是生成html,也可以根据模板生成html，当然还有其他的功能，具体看插件介绍。下面是的配置：
引入插件
<span class="hljs-comment">// webpack.config.js</span>
<span class="hljs-keyword">var</span> HtmlWebpackPlugin = <span class="hljs-built_in">require</span>(<span class="hljs-string">'html-webpack-plugin'</span>);
配置 plugins，生成需要的html
<span class="hljs-comment">// webpack.config.js</span>
...
plugins:[
<span class="hljs-keyword">new</span> HtmlWebpackPlugin({
filename: <span class="hljs-string">'index.html'</span>,
template: __dirname + <span class="hljs-string">'/src/index.html'</span>,
<span class="hljs-keyword">inject</span>: <span class="hljs-string">'true'</span>
}),
<span class="hljs-keyword">new</span> HtmlWebpackPlugin({
filename: <span class="hljs-string">'html/hrm.html'</span>,
template: __dirname + <span class="hljs-string">'/src/html/hrm.html'</span>,
<span class="hljs-keyword">inject</span>: <span class="hljs-keyword">false</span>,
}),
<span class="hljs-keyword">new</span> HtmlWebpackPlugin({
filename: <span class="hljs-string">'html/home.html'</span>,
template: __dirname + <span class="hljs-string">'/src/html/home.html'</span>,
<span class="hljs-keyword">inject</span>: <span class="hljs-keyword">false</span>,
}),
]
...
我们前面说过，webpack 默认只识别 js 文件，所以对于html也要使用对应的loader:
<span class="hljs-comment">// webpack.config.js</span>
...
<span class="hljs-string">loaders:</span>[
{<span class="hljs-string">test:</span> <span class="hljs-regexp">/\.html$/</span>,<span class="hljs-string">loader:</span> <span class="hljs-string">"html"</span>},
]
...
引用图片和字体
引用图片和字体，需要对应的loader,并且可以设置这些资源大小的临界值，当小于临界值的时候，字体或者图片文件会以base64的形式在html引用，否则则是以资源路径的形式引用。如下：
<span class="hljs-comment">// webpack.config.js</span>
<span class="hljs-comment">// 图片 loader</span>
{
test: <span class="hljs-regexp">/\.(png|gif|jpe?g)$/</span>,
loader: <span class="hljs-string">'url-loader'</span>,
query: {
<span class="hljs-comment">/*
* limit=10000 ： 10kb
* 图片大小小于10kb 采用内联的形式，否则输出图片
* */</span>
limit: <span class="hljs-number">10000</span>,
name: <span class="hljs-string">'/img/[name]-[hash:8].[ext]'</span>
}
},
<span class="hljs-comment">// 字体loader</span>
{
test: <span class="hljs-regexp">/\.(eot|woff|woff2|ttf|svg)$/</span>,
loader: <span class="hljs-string">'url-loader'</span>,
query: {
limit: <span class="hljs-number">5000</span>,
name: <span class="hljs-string">'/font/[name]-[hash:8].[ext]'</span>
}
},
资源文件的压缩
js、css、html的压缩是少不了的，webpack 自带了压缩插件，如果某些对象名称不想被压缩，可以排除不想要压缩的对象名称。配置如下：
// webpack.config.js
...
plugin<span class="hljs-variable">s:</span>[
<span class="hljs-keyword">new</span> webpack.optimize.UglifyJsPlugin({
mangle: { // 排除不想要压缩的对象名称
excep<span class="hljs-variable">t:</span> [<span class="hljs-string">'$super'</span>, <span class="hljs-string">'$'</span>, <span class="hljs-string">'exports'</span>, <span class="hljs-string">'require'</span>, <span class="hljs-string">'module'</span>, <span class="hljs-string">'_'</span>]
},
compres<span class="hljs-variable">s:</span> {
warning<span class="hljs-variable">s:</span> false
},
outpu<span class="hljs-variable">t:</span> {
comment<span class="hljs-variable">s:</span> false,
}
})
]
...
使用jquery、underscore
通过webpack编译输出后的项目中，虽然页面已经引用了jquery、underscore,但是还是无法直接使用‘$’、‘_’对象，我们可以这样：
<span class="hljs-keyword">var</span> $ = <span class="hljs-built_in">require</span>(<span class="hljs-string">'jquery'</span>)；
<span class="hljs-keyword">var</span> _ = <span class="hljs-built_in">require</span>(<span class="hljs-string">'underscore'</span>)；
但是这样实在不方便，如果我们就是要使用‘$’、‘_’对象直接操作，webpack 内置的插件可以帮我们解决。具体如下：
<span class="hljs-comment">// webpack.config.js</span>
<span class="hljs-keyword">new</span> webpack.ProvidePlugin({
$: <span class="hljs-string">"jquery"</span>,
jQuery: <span class="hljs-string">"jquery"</span>,
<span class="hljs-string">"window.jQuery"</span>: <span class="hljs-string">"jquery"</span>,
<span class="hljs-string">"_"</span>: <span class="hljs-string">"underscore"</span>,
}),
代码分割，按需加载
在单页面应用中，当我们加载其他的模板文件时，想要引用这个模板文件对应的js。如果我们通过这种方式require(),那么webpack会将这个模板文件对应的js也会和当前js打包成一个js。如果项目比较大，那么js文件也将越来越大。我们希望的是加载模板文件的时候动态的引用这个模板文件对应的js。那么我们可以通过 require.ensure()的方式。
比如现在有两个导航菜单：
<span class="hljs-tag"><<span class="hljs-name">ul</span>></span>
<span class="hljs-tag"><<span class="hljs-name">li</span>></span><span class="hljs-tag"><<span class="hljs-name">a</span> <span class="hljs-attr">href</span>=<span class="hljs-string">"#home"</span>></span>home<span class="hljs-tag"></<span class="hljs-name">a</span>></span><span class="hljs-tag"></<span class="hljs-name">li</span>></span>
<span class="hljs-tag"><<span class="hljs-name">li</span>></span><span class="hljs-tag"><<span class="hljs-name">a</span> <span class="hljs-attr">href</span>=<span class="hljs-string">"#hrm"</span>></span>HRM<span class="hljs-tag"></<span class="hljs-name">a</span>></span><span class="hljs-tag"></<span class="hljs-name">li</span>></span>
<span class="hljs-tag"></<span class="hljs-name">ul</span>></span>
我们给这两个菜单绑定点击事件，当点击‘home’时引用对应的‘home.js’;当点击‘HRM’时引用对应的‘hrm.js’,那么大致可以这样：
<span class="hljs-function"><span class="hljs-keyword">function</span> <span class="hljs-title">loadJs</span>(<span class="hljs-params">jsPath</span>) </span>{
<span class="hljs-keyword">var</span> currentMod;
<span class="hljs-keyword">if</span> (jsPath === <span class="hljs-string">'./home'</span>) {
<span class="hljs-built_in">require</span>.ensure([], <span class="hljs-function"><span class="hljs-keyword">function</span> (<span class="hljs-params">require</span>) </span>{
currentMod = <span class="hljs-built_in">require</span>(<span class="hljs-string">'./home'</span>);
}, <span class="hljs-string">'home'</span>);
}
<span class="hljs-keyword">else</span> <span class="hljs-keyword">if</span> (jsPath === <span class="hljs-string">'./hrm'</span>) {
<span class="hljs-built_in">require</span>.ensure([], <span class="hljs-function"><span class="hljs-keyword">function</span> (<span class="hljs-params">require</span>) </span>{
currentMod = <span class="hljs-built_in">require</span>(<span class="hljs-string">'./hrm'</span>);
}, <span class="hljs-string">'hrm'</span>);
}
}
全局环境变量
有时我们只有在开发过程中，才想输出log日志。可以用以下webpack内置的插件解决：
<span class="hljs-comment">// webpack.config.js</span>
...
plugins:[
new webpack.DefinePlugin({
<span class="hljs-comment">// 全局debug标识</span>
__DEV__: debug,
}),
]
...
这时代码中就可以这么写了：
<span class="hljs-keyword">if</span> (<span class="hljs-variable">__DEV__</span>) {
console.<span class="hljs-built_in">log</span>(<span class="hljs-string">'debug 模式'</span>);
}
清空发布目录
发布前清空发布目录是有必要的，我们可以通过‘clean-webpack-plugin’插件解决：
引入插件：
<span class="hljs-comment">// webpack.config.js</span>
<span class="hljs-keyword">var</span> CleanWebpackPlugin = <span class="hljs-built_in">require</span>(<span class="hljs-string">'clean-webpack-plugin'</span>);
配置plugins:
<span class="hljs-comment">// webpack.config.js</span>
...
<span class="hljs-string">plugins:</span>[
<span class="hljs-keyword">new</span> CleanWebpackPlugin([<span class="hljs-string">'dist'</span>], {
<span class="hljs-symbol"> root:</span> <span class="hljs-string">''</span>, <span class="hljs-comment">// An absolute path for the root of webpack.config.js</span>
<span class="hljs-symbol"> verbose:</span> <span class="hljs-literal">true</span>,<span class="hljs-comment">// Write logs to console.</span>
<span class="hljs-symbol"> dry:</span> <span class="hljs-literal">false</span> <span class="hljs-comment">// Do not delete anything, good for testing.</span>
}),
]
...
热更新结合后端服务
热更新
热更新可以在你代码改变的时候即时编译输出，不用每次都要从都重新编译一遍，并且除了第一次编译比较慢，后面的编译都是增量编译，速度很快。有了这个功能，我们就不需要，每次都从头编译一次了。配置如下：
<span class="hljs-comment">// webpack.config.js</span>
...
<span class="hljs-string">plugins:</span> [
<span class="hljs-comment">// Enable multi-pass compilation for enhanced performance</span>
<span class="hljs-comment">// in larger projects. Good default.</span>
<span class="hljs-keyword">new</span> webpack.HotModuleReplacementPlugin({
<span class="hljs-symbol"> multiStep:</span> <span class="hljs-literal">true</span>
}),
],
<span class="hljs-string">devServer:</span> {
<span class="hljs-comment">// Enable history API fallback so HTML5 History API based</span>
<span class="hljs-comment">// routing works. This is a good default that will come</span>
<span class="hljs-comment">// in handy in more complicated setups.</span>
<span class="hljs-symbol"> historyApiFallback:</span> <span class="hljs-literal">true</span>,
<span class="hljs-comment">// Unlike the cli flag, this doesn't set</span>
<span class="hljs-comment">// HotModuleReplacementPlugin!</span>
<span class="hljs-symbol"> hot:</span> <span class="hljs-literal">true</span>,
<span class="hljs-symbol"> inline:</span> <span class="hljs-literal">true</span>,
<span class="hljs-comment">// Display only errors to reduce the amount of output.</span>
<span class="hljs-symbol"> stats:</span> <span class="hljs-string">'errors-only'</span>,
<span class="hljs-symbol">
host:</span> <span class="hljs-string">"localhost"</span>, <span class="hljs-comment">// Defaults to `localhost` process.env.HOST</span>
<span class="hljs-symbol"> port:</span> <span class="hljs-string">"8080"</span>, <span class="hljs-comment">// Defaults to 8080 process.env.PORT</span>
}
...
这时我们只要打开浏览器，输入：localhost:8080/ 就能看到结果，并且在你修改某些源文件后，浏览器会自动刷新，就能看到webpack 即时编译输出的结果，而不需要重新编译。
结合后端服务
我们在使用webpack开发时难免要结合后端服务开发，比如我们用webstorm 编译器开发项目，需要调用java的服务，由于有同源策略问题，这时我们会收到相关报错信息。这时我们可以通过代理的方式绕过同源策略。
这里我用nodejs 模拟一个后端服务，如下：
<span class="hljs-comment">// ~/mockServer/server.js</span>
<span class="hljs-keyword">var</span> http = <span class="hljs-built_in">require</span>(<span class="hljs-string">'http'</span>);
<span class="hljs-keyword">var</span> content = <span class="hljs-string">'▍if you see that,It means you have get the correct data by backend server(mock data by nodejs server)!'</span>;
<span class="hljs-keyword">var</span> srv = http.createServer(<span class="hljs-function"><span class="hljs-keyword">function</span> (<span class="hljs-params">req, res</span>) </span>{
res.writeHead(<span class="hljs-number">200</span>, {<span class="hljs-string">'Content-Type'</span>: <span class="hljs-string">'application/text'</span>});
res.end(content);
});
srv.listen(<span class="hljs-number">8888</span>, <span class="hljs-function"><span class="hljs-keyword">function</span>() </span>{
<span class="hljs-built_in">console</span>.log(<span class="hljs-string">'listening on localhost:8888'</span>);
});
接下来我们需要这样配置去调用这个nodejs 的服务。
首先将热更新配置的代码修改为：
<span class="hljs-comment">// webpack.config.js</span>
...
plugins: [
<span class="hljs-comment">// Enable multi-pass compilation for enhanced performance</span>
<span class="hljs-comment">// in larger projects. Good default.</span>
<span class="hljs-keyword">new</span> webpack.HotModuleReplacementPlugin({
<span class="hljs-attr">multiStep</span>: <span class="hljs-literal">true</span>
}),
],
<span class="hljs-attr">devServer</span>: {
<span class="hljs-comment">// Enable history API fallback so HTML5 History API based</span>
<span class="hljs-comment">// routing works. This is a good default that will come</span>
<span class="hljs-comment">// in handy in more complicated setups.</span>
historyApiFallback: <span class="hljs-literal">true</span>,
<span class="hljs-comment">// Unlike the cli flag, this doesn't set</span>
<span class="hljs-comment">// HotModuleReplacementPlugin!</span>
hot: <span class="hljs-literal">true</span>,
<span class="hljs-attr">inline</span>: <span class="hljs-literal">true</span>,
<span class="hljs-comment">// Display only errors to reduce the amount of output.</span>
stats: <span class="hljs-string">'errors-only'</span>,
<span class="hljs-attr">host</span>: <span class="hljs-string">"localhost"</span>, <span class="hljs-comment">// Defaults to `localhost` process.env.HOST</span>
port: <span class="hljs-string">"8080"</span>, <span class="hljs-comment">// Defaults to 8080 process.env.PORT</span>
proxy: {
<span class="hljs-string">'/devApi/*'</span>: {
<span class="hljs-attr">target</span>: <span class="hljs-string">'http://localhost:8888/'</span>,
<span class="hljs-attr">secure</span>: <span class="hljs-literal">true</span>,
<span class="hljs-comment">/*
* rewrite 的方式扩展性更强，不限制服务的名称
* */</span>
rewrite: <span class="hljs-function"><span class="hljs-keyword">function</span> (<span class="hljs-params">req</span>) </span>{
req.url = req.url.replace(<span class="hljs-regexp">/^\/devApi/</span>, <span class="hljs-string">''</span>);
}
}
}
}
...
然后配置一个全局的环境变量，通过
：
<span class="hljs-comment">// webpack.config.js</span>
...
plugins: [
new webpack.DefinePlugin({
__DEVAPI__: devServer ? <span class="hljs-string">"/devApi/"</span> : <span class="hljs-string">"''"</span>,
}),
]
...
最后在调用服务的地方，只需要在调用地址前添加
全局环境变量即可，如：
$.ajax({
ur<span class="hljs-variable">l:</span> __DEVAPI__ + <span class="hljs-string">'http://localhost:8888/'</span>,
dat<span class="hljs-variable">a:</span> {},
<span class="hljs-built_in">type</span>: <span class="hljs-string">'get'</span>,
dataType: <span class="hljs-string">'text'</span>,
succes<span class="hljs-variable">s:</span> <span class="hljs-function"><span class="hljs-keyword">function</span> <span class="hljs-params">(text)</span> {}</span>
})
这样在热更新的模式下，当有
的地方就会自动识别为
，而这里会通过代理处理帮你重写掉，绕过同源策略。
自动打开浏览器
虽然以上的工作几乎已经满足我们对webpack的要求了，但是我们还想懒一点，想在热更新模式下，编译完成后自动打开浏览器。那么我们可以通过这个插件open-browser-webpack-plugin解决：
引用插件
<span class="hljs-comment">// webpack.config.js</span>
<span class="hljs-keyword">var</span> OpenBrowserPlugin = <span class="hljs-built_in">require</span>(<span class="hljs-string">'open-browser-webpack-plugin'</span>);
配置插件，这个配置要根据项目的具体情况去配置：
<span class="hljs-comment">// webpack.config.js</span>
...
<span class="hljs-string">plugins:</span> [
<span class="hljs-keyword">new</span> OpenBrowserPlugin({<span class="hljs-string">url:</span> <span class="hljs-string">'http://localhost:8080'</span> + PATHS.publicPath + <span class="hljs-string">'index.html'</span>})
]
...
总结
以上就是这篇文章的主要内容，希望通过这篇文章能够给大家带来一些启发。如果有觉得哪里不对，或者不合理的地方，欢迎指出。其实webpack还有一个关于版本号的bug，不知道是不是有人解决了，如果有人已经解决了，还请分享。
进阶部分转载自 https://segmentfault.com/a/1190000005866410
