Webpack快速入门教程
本文介绍的 webpack 快速入门教程,是针对和我一样,虽然在网上看了很多教程,依然对很多选项存在疑惑的童鞋,静下心来,花点时间慢慢详细的阅读,相信你看完本文后,你的疑惑会一一解开。当然也有之前没有接触过 Webpack 的你,如果对 Webpack 感兴趣的话,边看本文边学能够自始至终的按着步骤敲一遍代码,你就会发现自己已经走进了 Webpack 的世界了,因为这些内容都是我自己亲身实践过的。
Webpack 做了什么
一句话简单来解释就是处理模块依赖,并将它们合并成可用的静态资源。
为什么选 Webpack
模块打包工具有很多,Webpack 的特点是它依赖的模块可以是 js 文件,也可以是 css 文件,只要配置对应的 webpack-loader(加载器),.coffee、.sass、.jade 等等任意的静态资源文件都可以被引用,并解析。
例如:我在项目中使用 Vue 框架,在配置官方提供的 loader 后,就可以直接在 js 中依赖.vue 后缀的单文件组件了。
WebPack 和 Grunt 以及 Gulp 相比有什么特性
其实 Webpack 和另外两个并没有太多的可比性,Gulp/Grunt 是一种能够优化前端的开发流程的工具,而 WebPack 是一种模块化的解决方案,不过 Webpack 的优点使得 Webpack 在很多场景下可以替代 Gulp/Grunt 类的工具。
Grunt 和 Gulp 的工作方式是:在一个配置文件中,指明对某些文件进行类似编译,组合,压缩等任务的具体步骤,工具之后可以自动替你完成这些任务。
Webpack 的工作方式是:把你的项目当做一个整体,通过一个给定的主文件(如:index.js),Webpack 将从这个文件开始找到你的项目的所有依赖文件,使用 loaders 处理它们,最后打包为一个(或多个)浏览器可识别的 JavaScript 文件。
二者进行比较,Webpack 的处理速度更快更直接,能打包更多不同类型的文件。
webpack 上手
安装
新建一个文件夹(文件名自己定义,我这里命名为 webpacksampleproject),作为我们练习 webpack 存放文件。这里使用 npm 指令安装 webpack,在终端中转到该文件夹后执行下述指令就可以完成安装。
//全局安装 npm install -g webpack//安装到你的项目目录 npm install --save-dev webpack
使用 webpack 前的准备工作
使用 npminit 在我们创建好的文件夹内创建 package.json,这是一个标准的 npm 说明文件,里面蕴含了丰富的信息,包括当前项目的依赖模块,自定义的脚本任务等等。在终端中使用 npm init 命令可以自动创建这个 package.json 文件。
Npm init
package.json 文件安装成功后,安装 Webpack 在当前项目中作为依赖包
// 安装 Webpack npm install --save-dev webpack
回到之前的空文件夹,并在里面创建两个文件夹,app 文件夹和 public 文件夹,app 文件夹用来存放原始数据和我们将写的 JavaScript 模块,public 文件夹用来存放之后供浏览器读取的文件(包括使用 webpack 打包生成的 js 文件以及一个 index.html 文件)。接下来我们再创建三个文件:
1、index.html –放在 public 文件夹中;
2、Greeter.js–放在 app 文件夹中;
3、main.js–放在 app 文件夹中;
项目结构图如下:
然后,我们在 index.html 文件中写入一段 html 代码,用于引入打包后的 js 文件(这里我们先把之后打包后的 js 文件命名为 bundle.js,之后我们还会详细讲述)。
<!-- index.html --> <div id="root"></div> <script src="bundle.js"></script>
在 Greeter.js 中定义一个返回包含问候信息的 html 元素的函数,并依据 CommonJS 规范导出这个函数为一个模块:
// Greeter.js module.exports = function() { var greet = document.createElement('div'); greet.textContent = "Hi there and greetings!"; return greet; };
main.js 文件中我们写入下述代码,用以把 Greeter 模块返回的节点插入页面。
//main.js const greeter = require('./Greeter.js');document.querySelector("#root").appendChild(greeter());
正式使用 Webpack
webpack 可以在终端中使用,在基本的使用方法如下:
# {extry file}出填写入口文件的路径,本文中就是上述 main.js 的路径,# {destination for bundled file}处填写打包文件的存放路径# 填写路径的时候不用添加{}
webpack {entry file} {destination for bundled file}
指定入口文件后,webpack 将自动识别项目所依赖的其它文件,不过需要注意的是如果你的 webpack 不是全局安装的,那么当你在终端中使用此命令时,需要额外指定其在 node_modules 中的地址,继续上面的例子,在终端中输入如下命令
# webpack 非全局安装的情况 node_modules/.bin/webpack app/main.js public/bundle.js
可以看出 webpack 同时编译了 main.js 和 Greeter,js,现在打开 index.html,可以看到如下结果:
看到这个页面说明你已经成功的使用 Webpack 打包了一个文件了。不过在终端中进行复杂的操作,其实是不太方便且容易出错的,接下来看看 Webpack 的另一种更常见的使用方法。
通过配置文件来使用 Webpack
Webpack 拥有很多其它的比较高级的功能(比如说本文后面会介绍的 loaders 和 plugins),这些功能其实都可以通过命令行模式实现,但是正如前面提到的,这样不太方便且容易出错的,更好的办法是定义一个配置文件,这个配置文件其实也是一个简单的 JavaScript 模块,我们可以把所有的与打包相关的信息放在里面。
继续上面的例子来说明如何写这个配置文件,在当前练习文件夹的根目录下新建一个名为 webpack.config.js 的文件,我们在其中写入如下所示的简单配置代码,目前的配置主要涉及到的内容是入口文件路径和打包后文件的存放路径。
module.exports = { entry: __dirname + "/app/main.js",//已多次提及的唯一入口文件 output: { path: __dirname + "/public",//打包后的文件存放的地方 filename: "bundle.js"//打包后输出文件的文件名 } }
注:“__dirname”是 node.js 中的一个全局变量,它指向当前执行脚本所在的目录。
有了这个配置之后,再打包文件,只需在终端里运行 webpack(非全局安装需使用 node_modules/.bin/webpack)命令就可以了,这条命令会自动引用 webpack.config.js 文件中的配置选项,示例如下:
又学会了一种使用 Webpack 的方法,这种方法不用管那烦人的命令行参数,有没有感觉很爽。如果我们可以连 webpack(非全局安装需使用 node_modules/.bin/webpack)这条命令都可以不用,那种感觉会不会更爽~,继续看下文。
更快捷的执行打包任务
在命令行中输入命令需要代码类似于 node_modules/.bin/webpack 这样的路径其实是比较烦人的,不过值得庆幸的是 npm 可以引导任务执行,对 npm 进行配置后可以在命令行中使用简单的 npm start 命令来替代上面略微繁琐的命令。在 package.json 中对 scripts 对象进行相关设置即可,设置方法如下。
在命令行中输入命令需要代码类似于 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 就可以打包文件了,有没有觉得 webpack 也不过如此嘛,不过不要太小瞧 webpack,要充分发挥其强大的功能我们需要修改配置文件的其它选项,一项项来看。
Webpack 的强大功能
生成 SourceMaps(使调试更容易)
开发总是离不开调试,方便的调试能极大的提高开发效率,不过有时候通过打包后的文件,你是不容易找到出错了的地方,对应的你写的代码的位置的,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://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 是 webpack 提供的核心概念之一。通过使用不同的 loader,webpack 有能力调用外部的脚本或工具,实现对不同格式的文件的处理,比如说分析转换 scss 为 css,或者把下一代的 JS 文件(ES6,ES7)转换为现代浏览器兼容的 JS 文件,对 React 的开发而言,合适的 Loaders 可以把 React 的中用到的 JSX 文件转换为 JS 文件。
Loaders 需要单独安装并且需要在 webpack.config.js 中的 modules 关键字下进行配置,Loaders 的配置包括以下几方面:
1、test:一个用以匹配 loaders 所处理文件的拓展名的正则表达式(必须)
2、loader:loader 的名称(必须)
3、include/exclude:手动添加必须处理的文件(文件夹)或屏蔽不需要处理的文件(文件夹)(可选);
4、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 的平台,它可以编译代码帮你达到以下目的:
1、让你能使用最新的 JavaScript 代码(ES6,ES7…),而不用管新标准是否被当前使用的浏览器完全支持;
2、让你能使用基于 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 ({config.greetText}); } } export default Greeter
修改 main.js 如下,使用 ES6 的模块定义和渲染 Greeter 模块
// main.js import React from 'react'; import {render} from 'react-dom'; import Greeter from './Greeter'; render(, document.getElementById('root'));
重新使用 npm start 打包,如果之前打开的本地服务器没有关闭,你应该可以在 localhost:8080 下看到与之前一样的内容,这说明 react 和 es6 被正常打包了。
Babel 的配置
Babel 其实可以完全在 webpack.config.js 中进行配置,但是考虑到 babel 具有非常多的配置选项,在单一的 webpack.config.js 文件中进行配置往往使得这个文件显得太复杂,因此一些开发者支持把 babel 的配置选项放在一个单独的名为 “.babelrc” 的配置文件中。我们现在的 babel 的配置并不算复杂,不过之后我们会再加一些东西,因此现在我们就提取出相关部分,分两个配置文件进行配置(webpack 会自动调用.babelrc 里的 babel 配置选项),如下:
module.exports = { entry: __dirname + "/app/main.js",//已多次提及的唯一入口文件 output: { path: __dirname + "/public",//打包后的文件存放的地方 filename: "bundle.js"//打包后输出文件的文件名 }, devtool: 'eval-source-map', devServer: { contentBase: "./public",//本地服务器所加载的页面所在的目录 historyApiFallback: true,//不跳转 inline: true//实时刷新 }, module: { rules: [ { test: /(\.jsx|\.js)$/, use: { loader: "babel-loader" }, exclude: /node_modules/ } ] } }; //.babelrc { "presets": ["react", "env"] }
一切皆模块
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(, 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 (//使用 cssModule 添加类名的方法 {config.greetText}); } } export default Greeter
这样我们就可以放心的使用,即使相同的类名也不会造成不同组件之间的影响。
CSS modules 也是一个很大的主题,有兴趣的话可以去其官方文档了解更多。
CSS 预处理器
Sass 和 Less 之类的预处理器是对原生 CSS 的拓展,它们允许你使用类似于 variables,nesting,mixins,inheritance 等不存在于 CSS 中的特性来写 CSS,CSS 预处理器可以这些特殊类型的语句转化为浏览器可识别的 CSS 语句,
你现在可能都已经熟悉了,在 webpack 里使用相关 loaders 进行配置就可以使用了,以下是常用的 CSS 处理 loaders:
- Less Loader
- Sass Loader
- Stylus Loader
不过其实也存在一个 CSS 的处理平台-PostCSS,它可以帮助你的 CSS 实现更多的功能,在其可了解更多相关知识。
举例来说如何使用 PostCSS,我们使用 PostCSS 来为 CSS 代码自动添加适应不同浏览器的 CSS 前缀。
首先安装 postcss-loader 和 autoprefixer(自动添加前缀的插件)
pm install --save-dev postcss-loader autoprefixer
接下来,在 webpack 配置文件中添加 postcss-loader,在根目录新建 postcss.config.js,并添加如下代码之后,重新使用 npm start 打包时,你写的 css 会自动根据 Can i use 里的数据添加不同前缀了。
//webpack.config.jsmodule.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.jsmodule.exports = { plugins: [ require('autoprefixer') ] }
至此,本文已经谈论了处理 JS 的 Babel 和处理 CSS 的 PostCSS 的基本用法,它们其实也是两个单独的平台,配合 webpack 可以很好的发挥它们的作用。接下来介绍 Webpack 中另一个非常重要的功能-Plugins
插件(Plugins)
插件(Plugins)是用来拓展 Webpack 功能的,它们会在整个构建过程中生效,执行相关的任务。
Loaders 和 Plugins 常常被弄混,但是他们其实是完全不同的东西,可以这么来说,loaders 是在打包构建过程中用来处理源文件的(JSX,Scss,Less..),一次处理一个,插件并不直接操作单个文件,它直接对整个构建过程其作用。
Webpack 有很多内置插件,同时也有很多第三方插件,可以让我们完成更加丰富的功能。
使用插件的方法
要使用某个插件,我们需要通过 npm 安装它,然后要做的就是在 webpack 配置中的 plugins 关键字部分添加该插件的一个实例(plugins 是一个数组)继续上面的例子,我们添加了一个给打包后代码
const webpack = require('webpack'); module.exports = { ... module: { rules: [ { test: /(\.jsx|\.js)$/, use: { loader: "babel-loader" }, exclude: /node_modules/ }, { test: /\.css$/, use: [ { loader: "style-loader" }, { loader: "css-loader", options: { modules: true } }, { loader: "postcss-loader" } ] } ] }, plugins: [ new webpack.BannerPlugin('版权所有,翻版必究') ], };
通过这个插件,打包后的 JS 文件显示如下:
这就是 webpack 插件的基础用法了,下面给大家推荐几个常用的插件
HtmlWebpackPlugin
这个插件的作用是依据一个简单的 index.html 模板,生成一个自动引用你打包后的 JS 文件的新 index.html。这在每次生成的 js 文件名称不同时非常有用(比如添加了 hash 值)。
安装
npm install --save-dev html-webpack-plugin
这个插件自动完成了我们之前手动做的一些事情,在正式使用之前需要对一直以来的项目结构做一些更改:
1、移除 public 文件夹,利用此插件,index.html 文件会自动生成,此外 CSS 已经通过前面的操作打包到 JS 中了。
2、在 app 目录下,创建一个 index.tmpl.html 文件模板,这个模板包含 title 等必须元素,在编译过程中,插件会依据此模板生成最终的 html 页面,会自动添加所依赖的 css,js,favicon 等文件,index.tmpl.html 中的模板源代码如下:
<div id="root"></div>
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。
HotModuleReplacement
HotModuleReplacement(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.jsconst 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.jsconst 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" }, ... };
现在用户会有合理的缓存了。
去除 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 的详细使用可参考
总结
以上就是前端技术博客小编为大家整理的 webpack 内容,所用 webpack 基于最新的 webpack3.5.3。
这是一篇好长的文章,谢谢你的耐心,能仔细看到了这里,可能有些语句不通顺表达不清楚,还望海涵!其实关于 Webpack 本文讲述得仍不完全,不过相信你看完后已经进入 Webpack 的大门,能够更好的探索其它的关于 Webpack 的知识了。欢迎大家在文后发表自己的观点讨论。
码云笔记 » Webpack快速入门教程