天天看点

Webpack配置全解析(基础篇)

Webpack配置全解析(基础篇)

  Webpack凭借强大的功能,成为最流行和最活跃的打包工具,也是面试时高级程序员必须掌握的“软技能”;笔者结合在项目中的使用经验,介绍webpack的使用;本文是入门篇,主要介绍webpack的入口、输出和各种loader、plugins的使用以及开发环境的搭建。本文所有的demo代码均在https://github.com/acexyf/WebpackDemo

概念

  来看一下官网对webpack的定义:

Webpack配置全解析(基础篇)

本质上,webpack 是一个现代 JavaScript 应用程序的静态模块打包器(module bundler)。当 webpack 处理应用程序时,它会递归地构建一个依赖关系图(dependency graph),其中包含应用程序需要的每个模块,然后将所有这些模块打包成一个或多个bundle。

  首先webpack是一个静态模块打包器,所谓的静态模块,包括脚本、样式表和图片等等;webpack打包时首先遍历所有的静态资源,根据资源的引用,构建出一个依赖关系图,然后再将模块划分,打包出一个或多个bundle。再次白piao一下官网的图,生动的描述了这个过程:

Webpack配置全解析(基础篇)

  提到webpack,就不得不提webpack的四个核心概念

Webpack配置全解析(基础篇)

入口(entry):指示 webpack 应该使用哪个模块,来作为构建其内部依赖图的开始

Webpack配置全解析(基础篇)

输出(output):在哪里输出它所创建的 bundles

Webpack配置全解析(基础篇)

loader:让 webpack 能够去处理那些非 JavaScript 文件

Webpack配置全解析(基础篇)

插件(plugins):用于执行范围更广的任务

你的第一个打包器

  我们首先在全局安装webpack:

npm install webpack webpack-cli –g

  webpack可以不使用配置文件,直接通过命令行构建,用法如下:

webpack <entry> [<entry>] -o <output>

  这里的entry和output就对应了上述概念中的入口和输入,我们来新建一个入口文件:

Webpack配置全解析(基础篇)

  有了入口文件我们还需要通过命令行定义一下输入路径dist/bundle.js:

webpack index.js -o dist/bundle.js

  这样webpack就会在dist目录生成打包后的文件。

Webpack配置全解析(基础篇)

  我们也可以在项目目录新建一个html引入打包后的bundle.js文件查看效果。

配置文件

  命令行的打包方式仅限于简单的项目,如果我们的项目较为复杂,有多个入口,我们不可能每次打包都把入口记下来;因此一般项目中都使用配置文件来进行打包;配置文件的命令方式如下:

webpack [--config webpack.config.js]

  配置文件默认的名称就是

webpack.config.js

,一个项目中经常会有多套配置文件,我们可以针对不同环境配置不同的文件,通过

--config

来进行切换:

//生产环境配置

webpack --config webpack.prod.config.js

//开发环境配置

webpack --config webpack.dev.config.js

多种配置类型

  config配置文件通过

module.exports

导出一个配置对象:

Webpack配置全解析(基础篇)

  除了导出为对象,还可以导出为一个函数,函数中会带入命令行中传入的环境变量等参数,这样可以更方便的对环境变量进行配置;比如我们在打包线上正式环境和线上开发环境可以通过

env

进行区分:

Webpack配置全解析(基础篇)

  另外还可以导出为一个Promise,用于异步加载配置,比如可以动态加载入口文件:

Webpack配置全解析(基础篇)
Webpack配置全解析(基础篇)
Webpack配置全解析(基础篇)

入口

  正如在上面提到的,入口是整个依赖关系的起点入口;我们常用的单入口配置是一个页面的入口:

Webpack配置全解析(基础篇)

  它是下面的简写:

Webpack配置全解析(基础篇)

  但是我们一个页面可能不止一个模块,因此需要将多个依赖文件一起注入,这时就需要用到数组了,代码在demo2中:

Webpack配置全解析(基础篇)

  有时候我们一个项目可能有不止一个页面,需要将多个页面分开打包,entry支持传入对象的形式,代码在demo3中:

Webpack配置全解析(基础篇)

  这样webpack就会构建三个不同的依赖关系。

Webpack配置全解析(基础篇)
Webpack配置全解析(基础篇)

输出

  

output

选项用来控制webpack如何输入编译后的文件模块;虽然可以有多个entry,但是只能配置一个

output

Webpack配置全解析(基础篇)

  这里我们配置了一个单入口,输出也就是bundle.js;但是如果存在多入口的模式就行不通了,webpack会提示

Conflict: Multiple chunks emit assets to the same filename

,即多个文件资源有相同的文件名称;webpack提供了

占位符

来确保每一个输出的文件都有唯一的名称:

Webpack配置全解析(基础篇)

  这样webpack打包出来的文件就会按照入口文件的名称来进行分别打包生成三个不同的bundle文件;还有以下不同的占位符字符串:

Webpack配置全解析(基础篇)

  在这里引入Module、Chunk和Bundle的概念,上面代码中也经常会看到有这两个名词的出现,那么他们三者到底有什么区别呢?首先我们发现module是经常出现在我们的代码中,比如module.exports;而Chunk经常和entry一起出现,Bundle总是和output一起出现。

Webpack配置全解析(基础篇)

module:我们写的源码,无论是commonjs还是amdjs,都可以理解为一个个的module

Webpack配置全解析(基础篇)

chunk:当我们写的module源文件传到webpack进行打包时,webpack会根据文件引用关系生成chunk文件,webpack 会对这些chunk文件进行一些操作

Webpack配置全解析(基础篇)

bundle:webpack处理好chunk文件后,最后会输出bundle文件,这个bundle文件包含了经过加载和编译的最终源文件,所以它可以直接在浏览器中运行。

  我们通过下面一张图更深入的理解这三个概念:

Webpack配置全解析(基础篇)

总结:

  module,chunk 和 bundle 其实就是同一份逻辑代码在不同转换场景下的取了三个名字:我们直接写出来的是module,webpack处理时是chunk,最后生成浏览器可以直接运行的bundle。

Webpack配置全解析(基础篇)
Webpack配置全解析(基础篇)

hash、chunkhash、contenthash

  理解了chunk的概念,相信上面表中chunkhash和hash的区别也很容易理解了;

Webpack配置全解析(基础篇)

hash:是跟整个项目的构建相关,只要项目里有文件更改,整个项目构建的hash值都会更改,并且全部文件都共用相同的hash值。

Webpack配置全解析(基础篇)

chunkhash:跟入口文件的构建有关,根据入口文件构建对应的chunk,生成每个chunk对应的hash;入口文件更改,对应chunk的hash值会更改。

Webpack配置全解析(基础篇)

contenthash:跟文件内容本身相关,根据文件内容创建出唯一hash,也就是说文件内容更改,hash就更改。

Webpack配置全解析(基础篇)
Webpack配置全解析(基础篇)

模式

  在webpack2和webpack3中我们需要手动加入插件来进行代码的压缩、环境变量的定义,还需要注意环境的判断,十分的繁琐;在webpack4中直接提供了模式这一配置,开箱即可用;如果忽略配置,webpack还会发出警告。

Webpack配置全解析(基础篇)

  开发模式是告诉webpack,我现在是开发状态,也就是打包出来的内容要对开发友好,便于代码调试以及实现浏览器实时更新。

Webpack配置全解析(基础篇)

  生产模式不用对开发友好,只需要关注打包的性能和生成更小体积的bundle。看到这里用到了很多Plugin,不用慌,下面我们会一一解释他们的作用。

  相信很多童鞋都曾有过疑问,为什么这边DefinePlugin定义环境变量的时候要用

JSON.stringify("production")

,直接用

"production"

不是更简单吗?

  我们首先来看下

JSON.stringify("production")

生成了什么;运行结果是

""production""

,注意这里,并不是你眼睛花了或者屏幕上有小黑点,结果确实比

"production"

多嵌套了一层引号。

  我们可以简单的把DefinePlugin这个插件理解为将代码里的所有

process.env.NODE_ENV

替换为字符串中的

内容

。假如我们在代码中有如下判断环境的代码:

Webpack配置全解析(基础篇)

  这样生成出来的代码就会编译成这样:

Webpack配置全解析(基础篇)

  但是我们代码中可能并没有定义

production

变量,因此会导致代码直接报错,所以我们需要通过JSON.stringify来包裹一层:

Webpack配置全解析(基础篇)

  这样编译出来的代码就没有问题了。

Webpack配置全解析(基础篇)
Webpack配置全解析(基础篇)

自动生成页面

  在上面的代码中我们发现都是手动来生成index.html,然后引入打包后的bundle文件,但是这样太过繁琐,而且如果生成的bundle文件引入了hash值,每次生成的文件名称不一样,因此我们需要一个自动生成html的插件;首先我们需要安装这个插件:

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

  在demo3中,我们生成了三个不同的bundle.js,我们希望在三个不同的页面能分别引入这三个文件,如下修改config文件:

Webpack配置全解析(基础篇)

  我们以index.html作为模板文件,生成home、list、detail三个不同的页面,并且通过chunks分别引入不同的bundle;如果这里不写chunks,每个页面就会引入所有生成出来的bundle。

  html-webpack-plugin还支持以下字段:

Webpack配置全解析(基础篇)

  上面设置title后需要在模板文件中设置模板字符串:

<title><%= htmlWebpackPlugin.options.title %></title>

loader

  loader用于对模块module的源码进行转换,默认webpack只能识别commonjs代码,但是我们在代码中会引入比如vue、ts、less等文件,webpack就处理不过来了;loader拓展了webpack处理多种文件类型的能力,将这些文件转换成浏览器能够渲染的js、css。

  

module.rules

允许我们配置多个loader,能够很清晰的看出当前文件类型应用了哪些loader,loader的代码均在demo4中。

Webpack配置全解析(基础篇)

  我们可以看到rules属性值是一个数组,每个数组对象表示了不同的匹配规则;test属性时一个正则表达式,匹配不同的文件后缀;use表示匹配了这个文件后调用什么loader来处理,当有多个loader的时候,use就需要用到数组。

  多个loader支持链式传递,能够对资源进行流水线处理,上一个loader处理的返回值传递给下一个loader;loader处理有一个优先级,从右到左,从下到上;在上面demo中对css的处理就遵从了这个优先级,css-loader先处理,处理好了再给style-loader;因此我们写loader的时候也要注意前后顺序。

Webpack配置全解析(基础篇)
Webpack配置全解析(基础篇)

css-loader和style-loader

  css-loader和style-loader从名称看起来功能很相似,然而两者的功能有着很大的区别,但是他们经常会成对使用;安装方法:

npm i -D css-loader style-loader

  css-loader用来解释@import和url();style-loader用来将css-loader生成的样式表通过

<style>标签

,插入到页面中去。

Webpack配置全解析(基础篇)

  然后在入口文件中将index.css引入,就能看到打包的效果,页面中插入了三个style标签,代码在demo4:

Webpack配置全解析(基础篇)
Webpack配置全解析(基础篇)
Webpack配置全解析(基础篇)

sass-loader和less-loader

  这两个loader看名字大家也能猜到了,就是用来处理sass和less样式的。安装方法:

npm i -D sass-loader less-loader node-sass

  在config中进行配置,代码在demo4:

Webpack配置全解析(基础篇)
Webpack配置全解析(基础篇)
Webpack配置全解析(基础篇)

postcss-loader

  都0202年了,小伙伴肯定不想一个一个的手动添加-moz、-ms、-webkit等浏览器私有前缀;postcss提供了很多对样式的扩展功能;啥都不说,先安装起来:

npm i -D postcss-loader

  老规矩,还是在config中进行配置:

Webpack配置全解析(基础篇)

  正当我们兴冲冲的打包看效果时,发现样式还是老样子,并没有什么改变。

Webpack配置全解析(基础篇)

  这是因为postcss主要功能只有两个:第一就是把css解析成JS可以操作的抽象语法树AST,第二就是调用插件来处理AST并得到结果;所以postcss一般都是通过插件来处理css,并不会直接处理,所以我们需要先安装一些插件:

npm i -D autoprefixer postcss-plugins-px2rem cssnano

  在项目根目录新建一个

.browserslistrc

文件。

> 0.25%

last 2 versions

  我们将postcss的配置单独提取到项目根目录下的

postcss.config.js

Webpack配置全解析(基础篇)

  有了

autoprefixer

插件,我们打包后的css就自动加上了前缀。

Webpack配置全解析(基础篇)
Webpack配置全解析(基础篇)

babel-loader

  兼容低版本浏览器的痛相信很多童鞋都经历过,写完代码发现自己的js代码不能运行在IE10或者IE11上,然后尝试着引入各种polyfill;babel的出现给我们提供了便利,将高版本的ES6甚至ES7转为ES5;我们首先安装babel所需要的依赖:

Webpack配置全解析(基础篇)

  然后在config添加loader对js进行处理:

Webpack配置全解析(基础篇)

  同样的,我们把babel的配置提取到根目录,新建一个

.babelrc

文件:

Webpack配置全解析(基础篇)

  我们可以在index.js中尝试写一些es6的语法,看到代码会被转译成es5,代码在demo4中。由于babel-loader的转译速度很慢,在后面我们加入了时间插件后可以看到每个loader的耗时,babel-loader是最耗时间;因此我们要尽可能少的使用babel来转译文件,我们对config进行改进,

Webpack配置全解析(基础篇)

  正则上使用

$

来进行精确匹配,通过exclude将node_modules中的文件进行排除,include将只匹配src中的文件;可以看出来include的范围比exclude更缩小更精确,因此也是推荐使用include。

Webpack配置全解析(基础篇)
Webpack配置全解析(基础篇)

file-loader和url-loader

  file-loader和url-loader都是用来处理图片、字体图标等文件;url-loader工作时分两种情况:当文件大小小于limit参数,url-loader将文件转为base-64编码,用于减少http请求;当文件大小大于limit参数时,调用file-loader进行处理;因此我们优先使用url-loader,首先还是进行安装,安装url-loader之前还需要把file-loader先安装:

npm i file-loader url-loader -D

  接下来还是修改config:

Webpack配置全解析(基础篇)

  我们在css中给body添加一个小于10k的居中背景图片:

Webpack配置全解析(基础篇)

  打包后查看body的样式可以发现图片已经被替换成base64格式的url了,代码在demo4。

Webpack配置全解析(基础篇)
Webpack配置全解析(基础篇)
Webpack配置全解析(基础篇)

html-withimg-loader

  如果我们在页面上引用一个图片,会发现打包后的html还是引用了src目录下的图片,这样明显是错误的,因此我们还需要一个插件对html引用的图片进行处理:

npm i -D html-withimg-loader

  老样子还是在config中对html进行配置:

Webpack配置全解析(基础篇)

  然鹅,打开页面发现却是这样的:

Webpack配置全解析(基础篇)

  这是因为在url-loader中把每个图片作为一个模块来处理了,我们还需要去url-loader中修改:

Webpack配置全解析(基础篇)

  这样我们在页面上的图片引用也被修改了,代码在demo4中。

  html-withimg-loader会导致html-webpack-plugin插件注入title的模板字符串

<%= htmlWebpackPlugin.options.title %>

失效,原封不动的展示在页面上;因此,如果我们想保留两者的功能需要在配置config中把html-withimg-loader删除并且通过下面的方式来引用图片:

<img src="<%=require('./src/bg1.png') %>" alt="" srcset="">

Webpack配置全解析(基础篇)
Webpack配置全解析(基础篇)

vue-loader

  最后说一下一个比较特殊的vue-loader,看名字就知道是用来处理vue文件的。

npm i -D vue-loader vue-template-compiler

npm i -S vue

  我们首先来创建一个vue文件,具体代码在demo5中:

Webpack配置全解析(基础篇)

  然后在webpack的入口文件中引用它:

Webpack配置全解析(基础篇)

  不过vue-loader和其他loader不太一样,除了将它和

.vue

文件绑定之外,还需要引入它的一个插件:

Webpack配置全解析(基础篇)

  这样我们就能愉快的在代码中写vue了。

搭建开发环境

  在上面的demo中我们都是通过命令行打包生成dist文件,然后直接打开html或者通过

static-server

来查看页面的;但是开发中我们写完代码每次都来打包会严重影响开发的效率,我们期望的是写完代码后立即就能够看到页面的效果;webpack-dev-server就很好的提供了一个简单的web服务器,能够实时重新加载。

  首先在我们的项目中安装依赖:

npm i -D webpack webpack-dev-server

  webpack-dev-server的用法和wepack一样,只不过他会额外启动一个express的服务器。我们在项目中新建一个

webpack.dev.config.js

配置文件,单独对开发环境进行一个配置,相关代码在demo6中:

Webpack配置全解析(基础篇)

  通过命令行

webpack-dev-server

来启动服务器,启动后我们发现根目录并没有生成任何文件,因为webpack打包到了内存中,不生成文件的原因在于访问内存中的代码比访问文件中的代码更快。

  我们在public/index.html的页面上有时候会引用一些本地的静态文件,直接打开页面的会发现这些静态文件的引用失效了,我们可以修改server的工作目录,同时指定多个静态资源的目录:

Webpack配置全解析(基础篇)

  热更新(Hot Module Replacemen简称HMR)是在对代码进行修改并保存之后,webpack对代码重新打包,并且将新的模块发送到浏览器端,浏览器通过新的模块替换老的模块,这样就能在不刷新浏览器的前提下实现页面的更新。

Webpack配置全解析(基础篇)

  可以看出浏览器和webpack-dev-server之间通过一个websock进行连接,初始化的时候client端保存了一个打包后的hash值;每次更新时server监听文件改动,生成一个最新的hash值再次通过websocket推送给client端,client端对比两次hash值后向服务器发起请求返回更新后的模块文件进行替换。

  我们点击源码旁的行数看一下编译后的源码是什么样的:

Webpack配置全解析(基础篇)

  发现跟我们的源码差距还是挺大的,本来是一个简单add函数,通过webpack的模块封装,已经很难理解原来代码的含义了,因此,我们需要将编译后的代码映射回源码;devtool中不同的配置有不同的效果和速度,综合性能和品质后,我们一般在开发环境使用

cheap-module-eval-source-map

,在生产环境使用

source-map

Webpack配置全解析(基础篇)

  其他各模式的对比:

Webpack配置全解析(基础篇)

plugins

  在上面我们也介绍了DefinePlugin、HtmlWebpackPlugin等很多插件,我们发现这些插件都能够不同程度的影响着webpack的构建过程,下面还有一些常用的插件,plugins相关代码在demo7中。

Webpack配置全解析(基础篇)
Webpack配置全解析(基础篇)

clean-webpack-plugin

  clean-webpack-plugin用于在打包前清理上一次项目生成的bundle文件,它会根据output.path自动清理文件夹;这个插件在生产环境用的频率非常高,因为生产环境经常会通过hash生成很多bundle文件,如果不进行清理的话每次都会生成新的,导致文件夹非常庞大;这个插件安装使用非常方便:

npm i -D clean-webpack-plugin

  安装后我们在config中配置一下就可以了:

Webpack配置全解析(基础篇)
Webpack配置全解析(基础篇)
Webpack配置全解析(基础篇)

mini-css-extract-plugin

  我们之前的样式都是通过style-loader插入到页面中去,但是生产环境需要单独抽离样式文件,mini-css-extract-plugin就可以帮我从js中剥离样式:

npm i -D mini-css-extract-plugin

  我们在开发环境使用style-loader,生产环境使用mini-css-extract-plugin:

Webpack配置全解析(基础篇)

  引入loader后,我们还需要配置plugin,提取的css同样支持

output.filename

中的占位符字符串。

Webpack配置全解析(基础篇)
Webpack配置全解析(基础篇)

optimize-css-assets-webpack-plugin

  我们可以发现虽然配置了

production

模式,打包出来的js压缩了,但是打包出来的css确没有压缩;在生产环境我们需要对css进行一下压缩:

npm i optimize-css-assets-webpack-plugin -D

  然后也是引入插件:

Webpack配置全解析(基础篇)
Webpack配置全解析(基础篇)
Webpack配置全解析(基础篇)

copy-webpack-plugin

  和demo6中一样,我们在public/index.html中引入了静态资源,但是打包的时候webpack并不会帮我们拷贝到dist目录,因此copy-webpack-plugin就可以很好地帮我做拷贝的工作了

npm i -D copy-webpack-plugin

  在config中配置我们需要拷贝的源路径和目标路径:

Webpack配置全解析(基础篇)
Webpack配置全解析(基础篇)
Webpack配置全解析(基础篇)

ProvidePlugin

  ProvidePlugin可以很快的帮我们加载想要引入的模块,而不用require。一般我们加载jQuery需要先把它import:

Webpack配置全解析(基础篇)

  但是我们在config中配置ProvidePlugin插件后能够不用import,直接使用

$

Webpack配置全解析(基础篇)

  但是如果在项目中引入了太多模块并且没有require会让人摸不着头脑,因此建议加载一些常见的比如jQuery、vue、lodash等。

Webpack配置全解析(基础篇)
Webpack配置全解析(基础篇)
Webpack配置全解析(基础篇)

loader和plugin的区别

  介绍了这么多loader和plugin,我们来回顾一下他们两者的区别:

loader:由于webpack只能识别js,loader相当于翻译官的角色,帮助webpack对其他类型的资源进行转译的预处理工作。plugins:plugins扩展了webpack的功能,在webpack运行时会广播很多事件,plugin可以监听这些事件,然后通过webpack提供的API来改变输出结果。

Webpack配置全解析(基础篇)
Webpack配置全解析(基础篇)

总结

  最后,介绍了这么多,本文是webpack基础篇,还有很多生产环境的优化还没有写到;因此各位看官敬请期待优化篇。

继续阅读