🛴序言

在前面的两篇文章中，我们讲解了 webpack 的入门知识。但是呢，入门知识了解了之后，总得应用到具体的案例当中来。

因此，在下面的这篇文章中，将带领大家来了解关于 webpack 的一些实战案例配置，包括第三方库、 PWA 、 ts 的打包配置，以及 WebpackDevServer 的进阶操作，还有需重点掌握的，关于 webpack 如何做性能优化处理这个问题。

下面开始本文的介绍~🚦

🚌一、Library的打包

假设我们现在要开发一个组件库或者一个函数库时，对于这样的库代码，我们应该如何让 webpack 来进行打包呢？

1. webpack打包库

假如我们现在写了很多逻辑代码，同时呢，我们将这些逻辑代码进行打包，打包之后它全部生成在 dist 文件夹下的 mondaylib.js 文件中。

好了，现在这个库生成了。那如何让我们的用户，来引入 mondaylib 这个库呢？

一般情况下，别人引入我们的库的方法，具体有以下几种方式：

//方式一
import mondaylib from 'mondaylib'
//方式二
const mondaylib = require('mondaylib')
//方式三
require(['mondaylib'], function(){})

所以，如果想让我们的用户来引入这个库，我们需要在 webpack.config.js 下进行配置。具体配置如下：

const path = require('path');module.exports = {mode: 'production',entry: './src/index.js',output: {path: path.resolve(__dirname, 'dist'),filename: 'mondaylib.js',//此处配置libraryTarget，umd表示支持commonJS这种语法libraryTarget: 'umd'}
}

libraryTarget: 'umd' 表示支持 commonJS 这种语法，因此可以引入上面三种方式。同时， libraryTarget 也可以设置为其他值，比如 this 和 window 。

libraryTarget: 'this' 的意思为，我要让 mondaylib 这个变量，挂载到页面上。 libraryTarget: 'window' 则表示为， mondaylib 这个变量，将挂载到 window 上。

---

除了以上三种情况，还有另外特殊情况，具体如下：

<script src="mondaylib.js"></script>

此时我们需要在 webpack.config.js 中进行以下配置：

const path = require('path');module.exports = {mode: 'production',entry: './src/index.js',output: {path: path.resolve(__dirname, 'dist'),filename: 'mondaylib.js',//将打包生成的代码挂载到页面的全局变量上library: 'mondaylib',//此处配置libraryTarget，umd表示支持commonJS这种语法libraryTarget: 'umd'}
}

其中，第一个 library 是属性值，第二个 mondaylib 是我们的库名，这个配置的意思为，将打包生成的代码，即 mondaylib.js 这个库，给挂载到全局的变量上。

2. 库引用冲突

假设现在，我们在上面 mondaylib 这个库中，引入了 lodash 这个库。然后呢，当用户使用的时候，用户又再引入了一次lodash这个库。像下面代码这样：

import _ from 'lodash';
//mondaylib这个库原先已经引入过lodash这个库
import mondaylib from 'mondaylib';

所以现在，我们该如何来避免这种问题发生呢？我们再 webpack.config.js 中进行配置，具体代码如下：

const path = require('path');module.exports = {externals: ["lodash"]
}

从以上代码中我们可以知道，通过 externals: ["lodash"] 这个配置，来告诉 webpack ，告诉它说，如果在打包过程中， mondaylib 这个库中如果有遇到 lodash 这个库，那么就避开它，不要进行打包。通过这种方式，可以有效地避免库多次引用的问题，减少代码的打包大小。

---

externals 还有另外一种特殊配置，如下代码所示：

module.exports = {externals: {// 表明lodash这个库如果在commonjs这种环境下被使用，那么要求lodash加载的时候必须叫做lodashlodash: {commonjs: 'lodash'}}
}

如果这样配置，意在表明 lodash 这个库如果在 commonjs 这种环境下被使用，那么要求 lodash 加载的时候，必须命名为 lodash ，而不能随意命名。像下面这样：

//✔可使用方式：命名为lodash
import lodash from 'lodash'
//✘不可使用方式：未命名为lodash
import _ from 'lodash'

🚍二、PWA的打包配置

1. PWA是什么

PWA，全称为 Progressive Web Application ，即渐进式Web应用程序。

PWA 是一门比较新的前端技术，那它是一种什么样的技术呢？

PWA 可以实现的效果是，如果你访问一个网站，有可能第一次你访问成功了，但是呢，突然间这个网站的服务器挂掉了。那么这个时候你访问网站应该就是没办法访问了。但是呢， PWA 会将你第一次访问的页面给缓存起来。之后即使服务器挂掉了，你依然可以把之前看到的页面再展示出来。

因此， webpack 中有一个插件，可以来实现这样的效果。我们来了解一下~

2. webpack中的PWA

第一步： 安装插件。具体代码如下：

npm install workbox-webpack-plugin --save-dev

---

第二步： 在 webpack.prod.js 中引入该插件并使用。具体代码如下：

const WorkboxPlugin = require('workbox-webpack-plugin');module.exports = {plugins: [new WorkboxPlugin.GenerateSW({clientsClaim: true,skipWaiting: true})],
}

通常情况下，我们只需要在线上环境 prod 引入 PWA ，而在开发环境中不需要考虑这个问题。通过以上的配置，我们在项目打包完成之后， dist 目录下将生成两个新的文件，一个是 service-worker.js ，另外一个是 precache.js 文件，这两个文件就是供我们来使用 PWA 的。

---

第三步： 引入以上文件。具体代码如下：

if('serviceWorker' in navigator){window.addEventListener('load', () => {navigator.serviceWorker.register('/service-worker.js').then(registration => {console.log('service-worker registed');}).catch(error => {console.log('service-worker regist error');})})
}

我们需要在入口文件中，写一段业务代码，引入 service-worker.js 文件，来帮我们做 PWA 。这个时候我们对项目进行打包，之后呢，如果出现服务器突然挂了的情况，那也不用担心， PWA 会帮我们加载原先的页面来提供给我们浏览。

🚎三、TypeScript的打包配置

1. 引例阐述

我们都知道，对于不同的开发者来说，不同的人写出的代码风格形式各异，这样在后期，项目的维护性就很难得到保证。那么，这个时候，风靡于2018年的 Typescript 出现了。 ts 规范了一套 js 的标准，因此，我们在项目代码的编写中，通过 ts ，就可以规范我们的代码，并且使得我们项目的维可维护性和可扩展性变得更好了。

接下来，我们就来了解一下，如何通过 webpack 的配置变更，来实现对 ts 语法的支持。

2. webpack对ts的配置

（1）背景

假设我们现在有这么一段 ts 的代码需要进行编译，具体代码如下：

class Greeter{greeting: string;constructor(message: string){this.greeting = message;}greet(){return "Hello, " + this.greeting;}
}let greeter = new Greeter("world");let button = document.createElement('button');
button.textContent = "Say Hello";
button.click = function(){alert(greeter.greet());
}document.body.appendChild(button);

现在，我们想要让 webpack 来对这段 ts 代码进行编译，该怎么处理呢？

（2）配置步骤

第一步： 安装 ts-loader 。具体命令如下：

npm install ts-loader typescript -D

第二步： 我们在 webpack.config.js 文件下进行配置。具体代码如下：

const path = require('path');module.exports = {mode: 'production',entry: './src/index.tsx',module: {rules: [{test: /\.tsx?$/,use: 'ts-loader',exclude: /node_modules/ }]},output: {filename: 'bundle.js',path: path.resolve(__dirname, 'dist')}
}

第三步： 配置 tsconfig.json 文件。具体代码如下：

{"compilerOptions": {"outDir": "./dist","module": "es6","target": "es5","allowJs": true}
}

3. ts识别第三方库

有时候，我们会调用 lodash 中的 join 方法，但是呢，如果我们不进行特殊处理的话，在 tsx 文件中正常引入 lodash 这个库并使用，是不会报错的。因此，我们需要来安装另外一个 ts 的库，来对它进行处理一下。具体步骤如下：

第一步： 安装 @types/lodash 库。具体命令如下：

npm install @types/lodash --save-dev

安装完这个库之后， ts 就可以去识别 lodash 的一些函数和方法，一旦出现引用不对，就会进行报错提示。

那有小伙伴就会有疑问说，是不是 ts 拥有所有这样的库（像 jQuery 等各种库）的类型文件呢？

答案当然是否定的。我们可以到 github 上的一个网址👉https://microsoft.github.io/TypeSearch/来进行搜索，如果搜索得到，那么我们就可以用 @type/库名 来进行安装，之后 tsx 文件就会支持对该库的类型检查。

🚕四、WebpackDevServer进阶操作

1. WebpackDevServer实现请求转发

一般情况下，我们可以通过 charles fiddler 工具，在本地搭建一个代理服务器。通过这台代理服务器，将我们想要请求的接口地址进行转发。

那在 webpack 中，给我们提供了一个工具， devServer.Proxy 。接下来，我们在 webpack.config.js 中进行配置，具体代码如下：

module.exports = {devServer: {proxy: {'/react/api': {target: 'http://www.mondaylab.com',//实现对https网址的请求转发secure: false,bypass: function(req, res, proxyOptions){//如果请求的内容是一个html地址，那么就直接返回根路径下index.html的内容if(req.headers.accept.indexOf('html') !== -1){console.log('Skipping proxy for browser request');return './index.html';// return false; //表示如果遇到html请求，那么该给你返回什么就返回什么}},//在前端请求时写header.json，webpack会间接的帮我们拿到demo.json的数据（请求转发】）pathRewrite: {'header.json': 'demo.json'},//如果有一些网站做了防爬虫，那么我们可能没办法进行跨域。需要进行如下配置，就可以突破对origin的限制changeOrigin: true,// 在请求头中自定义一些内容headers: {host: 'www.mondaylab.com',//在做请求转发时模拟一些登录等操作cookie: 'gfhgfh'}}}}
}

2. WebpackDevServer解决单页面应用路由问题

对于现代的的主流框架来说，像 vue.js 、React.js 等等框架，基本都是单页面应用。那么，在单页面应用里，比如我们想要从 http://mondaylab.com 跳转到 http://mondaylab.com/list ，该怎么样进行跳转呢？

这就要谈到一个单页面应用的路由问题。我们需要在 webpack.config.js 中进行如下配置：

module.exports = {devServer: {//第一种方式historyApiFallback: true,/*等同于historyApiFallback: {rewrites: [{from: /\.*\/,to: '/list.html/'}]}*//*第二种方式historyApiFallback: {rewrites: [{from: /abc.html/,//进行转换，当访问abc.html时，会把list.html的内容展示出来to: '/list.html/'}]}*//*第三种方式：更为灵活historyApiFallback: {rewrites: [{//表明在做页面的替换时，通过一个函数function的形式，结合context的一些参数//做一些js的逻辑放在里面，来决定最终它跳转到哪from: /^\/(libs)\/.*$/,to: function(context){return '/bower_components' + context.match[0];}}]}*/}
}

值得注意的是， historyApiFallback 只能用于开发环境下。如果到了线上环境的话，需要让后端的小伙伴去 nginx 或者 apache 上，仿照 webpackDevServer 的一些配置，在后端的服务器上做同样的配置，配置之后前端才可以使用对应的路由。

🚖五、ESLint在Webpack中的配置

1. ESLint是什么

在我们日常的团队开发中，每个人写的代码都各式各样，比如有的人喜欢在代码后边加个分号，有的人又不喜欢加。这间接地，就很容易导致我们项目的可维护性变差了。因此呢，我们就引入了 ESLint 这个内容，来约束的代码规范，让项目的可维护性和可扩展性变高。

那 ESLint 在 Webpack 中是怎么样配置的呢？

2. 如何安装ESLint

第一步： 安装 ESLint 工具。具体命令如下：

npm install eslint --save-dev

第二步： 约束我们的代码。我们需要新建一个配置文件，来对我们的ESLint规范进行配置。具体命令如下：

npx eslint --init
> Use a popular style guide 使用通用的代码检测模板
> Airbnb
> Do you use React 根据自身需求填y或者n
> Javascript
> Would you like to install them now with npm? Y

第三步： 使用 eslint 检测代码规范。具体代码如下：

npx eslint src

以上代码表示的是，使用eslint来检测src目录下的代码规范。

3. 为什么要在webpack中配置ESLint

在上面中我们了解到，每个开发的小伙伴都可以用命令行来检测自己的代码规范，但是如果每回写完一次代码，我们都要去运行这样的命令，才能看我们的代码写的合不合理，这样会不会就有点麻烦了。同时，我们又也不能保证每个人的 eslint 的代码规范设置是不是一样的。

因此，我们可以在 webpack 中来进行配置，解决上述所说的问题。具体步骤如下：

第一步： 安装 eslint-loader 。具体命令行如下：

npm install eslint-loader --save-dev

第二步： 配置 webpack.config.js 。具体代码如下：

module.exports = {devServer: {/*当我们运行webpack做打包时，一旦代码出现规范问题，webpack将会在浏览器上弹出一个报错层来提示我们*/overlay: true  },module: {rules: [{ test: /\.js$/, exclude: /node_modules/, use: ['babel-loader', 'eslint-loader']}]}
}

---

了解完基础配置之后，接下来我们来了解一些 eslint-loader 的一些其他配置。具体代码如下：

module.exports = {module: {rules: [{ test: /\.js$/, exclude: /node_modules/, use: ['babel-loader', {loader: 'eslint-loader',options: {//如果代码有一些比较浅显的问题，eslint-loader将会帮助我们自动修复fix: true,//降低eslint在打包过程中对项目性能的损耗cache: true},//强制eslint-loader先执行fore: 'pre'}]}]}
}

🏎️六、Webpack性能优化

细心的小伙伴可能已经发现，webpack的打包速度有时候可能会有一点点慢。这间接地，会浪费我们很多不该浪费的时间。所以，接下来就来谈谈，提升 Webpack 打包速度的几种方法。

1. 跟上技术的迭代(Node,Npm,Yarn)

如果我们想提升 webpack 的打包速度，我们可以升级 webpack 的版本，或者升级我们的node、npm管理器或者yarn的版本。

那为什么升级这些工具可以提升 webpack 的打包速度呢。

大家想一下， webpack 在做每一个版本的更新时，内部肯定会做很多版本的优化，因此，当我们做 webpack 的版本更新时，在速度上肯定会有所提升。 node 、 npm 、 yarn 的更新也是同样的道理。

试想一下，如果不提升，那它升级的意义又在哪呢？对吧。

2. 在尽可能少的模块上应用Loader

一般情况下，第三方模块的库都是已经进行打包编译过的，所以我们需要在引入 loader 来进行编译时，对 node_module 的文件给忽略掉，或者只在某个文件夹下使用某个 loader ，以此来增加我们的打包速度。我们可以在 webpack.config.js 中进行配置，具体代码如下：

module.exports = {module: {rules: [{ test: /\.js$/, exclude: /node_modules/,//或者以下这种方式->include//include: path.resolve(__dirname, '../src'),use: [{loader: 'babel-loader'}]}]}
}

当然，依据上面这个思路，还有其他的 loader 也都有其相对应的注意事项，这里不再展开细述。

3. 合理使用插件

插件要合理的使用，不要使用那些冗余的，没有意义的插件。同时呢，也要选择那些，性能比较好的，官方认可的插件来使用，这样，可以有效的来提升 webpack 的打包速度。

4. resolve参数合理配置

（1）常见配置

有时候，我们想要对我们引入的文件进行一些自定义的配置，该怎么处理呢？具体配置如下：

module.exports = {resolve: {extensions: ['js', 'jsx'],/*** 1.当你只引入一个目录时，比如 import Child from './child/child' ，* 这个时候webpack不知道我们具体是要引入哪个文件，* 那么会先去找index文件，如果找不到，那它会继续去找child文件*/mainFiles: ['index', 'child'],/*** alias, 顾名思义是别名。* 比如，想要将某个文件的引入方式改为自己的名字* import Child from './Child' -> import Child from 'monday'*/alias: {monday: path.resolve(__dirname, '../src/Child'),}},
}

接下来对以上的几个参数进行详细讲解。

（2）参数讲解

1）extensions

• 比如当引入 import Child from './child/child' 时，会先去找 './child/child.js' 文件，找不到再去找 './child/child.jsx' 文件。
• 一般不配置css和图片文件，因为css和图片可能数量会比较多，相应的会去执行很多次查找。间接地，本来想提升性能，结果又变成了浪费性能了。
• 所以，如果是像 css 和 jpg 等之类的资源文件，应该进行显式的引入；如果是像 js 和 jsx 之类的逻辑文件，可以在 extesions 中配置，进行显式的引入。

2）mainFiles

当你只引入一个目录时，比如 import Child from './child/child' ，这个时候 webpack 不知道我们具体是要引入哪个文件，那么会先去找 index 文件，如果找不到，那它会继续去找 child 文件。

3）alias

• alias , 顾名思义是别名。比如，想要将某个文件的引入方式改为自己的名字 → import Child from './Child' -> import Child from 'monday' 。
• 常用于多层级目录的情况下。

5. 使用DllPlugin提高打包速度

有时候，我们希望引入的第三方模块，只在第一次做打包的时候进行分析，而后续再做打包时就不要再进行分析了。那该怎么处理呢？

第一步： 新建 webpack.dll.js 文件，并进行配置。具体代码如下：

const path = require('path');
const webpack = require('webpack');module.exports = {mode: 'production',entry: {//此处填写我们想要单独进行打包的第三方库名vendors: ['react', 'react-dom', 'lodash']},output: {filename: '[name].dll.js',path: path.resolve(__dirname, '../dll'),/*用library把第三方模块里面的所有代码，通过全局变量的方式暴露出去*/library: '[name]'},plugins: [/*暴露完成之后，借助DllPlugin插件对暴露出来的模块代码进行分析，最终生成manifest.json的文件 */new webpack.DllPlugin({//对生成的vendors的库进行DllPlugin的分析(文件映射)name: '[name]',// 分析结果所放的路径，分析之后结合全局变量，在common.js中进行配置path: path.resolve(__dirname, '../dll/[name].manifest.json')})]}

第二步： 安装 add-asset-html-webpack-plugin 插件。具体命令如下：

npm install add-asset-html-webpack-plugin --save

第三步： 配置 webpack.common.js 文件。具体配置如下：

const AddAssetHtmlWebpackPlugin = require('add-asset-html-webpack-plugin');
const webpack = require('webpack');module.exports = {entry: {main: './src/index.js',plugins: [new HtmlWebpackPlugin({template: 'src/index.html'}), /*** 指的是要往HtmlWebpackPlugin插件生成的index.html中添加一些内容*/new AddAssetHtmlWebpackPlugin({filepath: path.resolve(__dirname, '../dll/vendors.dll.js')}),/*** 1.使用DllReferencePlugin插件，* 这个插件会到'../dll/vendors.manifest.json'中找第三方模块的映射关系，* 如果能找到映射关系，那么webpack就会知道，这个第三方模块没有必要再打包进来了，* 直接从vendors.dll.js中拿过来用就可以了* 2.如果发现并不再映射关系里面，那么才会再到node_modules中去找* */new webpack.DllReferencePlugin({manifest: path.resolve(__dirname, '../dll/vendors.manifest.json')})]}
}

第四步： 配置 package.json 文件。具体代码如下：

{"scripts": {"build:dll": "webpack --config ./build/webpack.dll.js"}
}

通过运行 npm run build:dll 命令，来实现对第三方库的打包。

6. 控制包文件大小

在我们做项目打包时，我们应该让我们打包生成的文件尽可能的小。有时我们在写代码的时候，经常会在页面里面引入一些没有用的模块，也就是引入一些我们使用的模块。

这个时候如果你没有配置 Tree-Shaking ，就会很容易造成打包的时候，出现大量冗余的代码。这些冗余代码呢，间接地，就会拖累我们 webpack 的打包速度。

所以呢，我们在做打包时，要控制好文件的大小。具体步骤参考如下：

• 配置 Tree-shaking ；
• 通过 SplittingChunk 来将一个大的文件分割成多个小的文件。

7. 多进程打包

webpack 是通过node来运行的，所以它的打包过程是单线程的。那有时候呢，我们也可以借助 node 里面的多进程，来帮助我们提升 webpack 的打包速度。

常见工具有 thread-loader ， parallel-webpack ， happypack 等工具，大家可以依据自身需求查找相关资料，选出最适合自己项目的工具，进行打包。这一块不再进行详细讲解~

8. 合理使用sourceMap

通常情况下， sourceMap 越详细，那么打包的速度就会越慢。所以在做打包的时候，要根据当前是开发环境还是生产环境，选出最合适的 sourceMap 配置，来生成我们对应的代码调错文件。

这样，一方面能保证我们即使发现代码里的错误问题。另一方面呢，也可以尽可能地提升打包速度。

9. 结合 stats 分析打包结果

在打包项目时，我们可以通过命令，来生成这次打包情况的 stats 文件，之后呢，通过借助一些线上或者本地的打包分析工具，来达到分析我们本次打包过程中的打包情况。

比如说，分析哪个模块打包的时间比较长，哪个模块打包分析的时间比较短等等内容，依据具体的情况进行优化。

10. 开发环境内存编译

使用 webpackDevServer 来进行编译，它不会把打包生成的文件放在 dist 目录中去，而是把其放到了我们电脑的内存中。

11. 开发环境无用插件剔除

比如说，我们在开发环境的情况下，并不需要对代码进行压缩。因此，对应的压缩插件我们就不要在开发环境中配置，只在生产环境中配置就好了。这样，可以减少一些不必要的打包时间。

🏍️七、多页面打包配置

通常情况来说，但凡我们在做打包的时候，基本上都是对单页面应用做打包。什么是单页面呢，也就是只有一个 index.html 文件。像目前比较主流的框架， vue 和 react 等框架，都是单页面应用。但是如果像一些比较老的框架，比如 jquery 和 zepto ，可能就需要进行多页面应用打包。

因此，顺着这个话题，我们来谈谈，在 webpack 中，如何对多页面应用，进行打包配置。

我们在 webpack.common.js 中进行配置，具体代码如下：

const HtmlWebpackPlugin = require('html-webpack-plugin');
module.exports = {entry: {//引入多个入口文件main: './src/index.js',list: './src/list.js'},plugins: [new HtmlWebpackPlugin({template: 'src/index.html',filename: 'index.html',//chunk表明这些html文件要引入的文件有哪些chunks: ['runtime', 'vendors', 'main']}),new HtmlWebpackPlugin({template: 'src/index.html',filename: 'list.html',chunks: ['runtime', 'vendors', 'list']})]
}

通过以上代码我们可以知道，增加 entry 和 plugins 的配置，来增加多个入口页面，从而达到了多页面应用配置的效果。

🛵八、结束语

通过上文的讲解，相信大家对 webpack 在一些场景中的实战配置有了一定的了解。上面讲述的也是比较浅显的内容，大家可以根据相对应的知识点，进行知识面的拓宽，以便更好的应用到实际的项目当中。

到这里，关于 webpack 的实战案例配置就讲解结束啦！希望对大家有帮助~

如文章有误或有不理解的地方，欢迎小伙伴们评论区留言哦💬

本文代码已上传至公众号，后台回复关键词 webpack 即可获取~

🐣彩蛋 One More Thing

（：往期推荐

• webpack入门基础知识👉不会webpack的前端可能是捡来的，万字总结webpack的超入门核心知识
• webpack入门进阶知识👉webpack入门核心知识还看不过瘾？速来围观进阶知识

（：番外篇

• 关注公众号星期一研究室，第一时间关注优质文章，更多精选专栏待你解锁~
• 如果这篇文章对你有用，记得留个脚印jio再走哦~
• 以上就是本文的全部内容！我们下期见！👋👋👋