📦 辛辛苦苦学会的 webpack dll 配置，可能已经过时了

如果大家看过一些 webpack4 优化的文章，一定会出现 dll 动态链接库。它以配置之复杂让众多初学者记忆犹新。今天我会以一个学习者的角度去一步一步探讨 webpack dll 的配置，最后得出一个完美的解决方案。

本文的内容和大部分讲解 webpack4 优化文章的观点不一样，如果有不同的见解，欢迎在评论区和我讨论。

友情提示

本文章不是入门教程，不会费大量笔墨去描写 webpack 的基础配置，请读者配合教程源代码食用。

1. 基础概念：dll 其实就是缓存

说实话我刚看见这个 dll 动态链接库的时候，我真被镇住了：这是什么玩意？怎么根本没听说过？

好学的我赶紧 Google 一下，在维基百科里找到了标准定义：

所谓动态链接，就是把一些经常会共享的代码制作成 DLL 档，当可执行文件调用到 DLL 档内的函数时，Windows 操作系统才会把 DLL 档加载存储器内，DLL 档本身的结构就是可执行档，当程序有需求时函数才进行链接。透过动态链接方式，存储器浪费的情形将可大幅降低。

唉，你们官方就是不说人话。

我结合 webpack，从前端的角度翻译一下：

具体到 webpack 这块儿，就是事先把常用但又构建时间长的代码提前打包好（例如 react、react-dom），取个名字叫 dll。后面再打包的时候就跳过原来的未打包代码，直接用 dll。这样一来，构建时间就会缩短，提高 webpack 打包速度。

我盯着上面那句话看了三分钟，什么 DLL，什么动态链接库，在前端世界里，不就是个缓存吗！都是拿空间换时间。

注：在这里狭义上可以理解为拿空间换时间，如果真的要探讨 dll 背后的知识：动态链接库和静态链接库，就又涉及到编译器的知识了，具体讲下去又是一篇新的文章了，所以暂时按下不表。

我们对比一下 DLL 和前端常接触的网络缓存，一张表就看明白了：

DLL	缓存
1.把公共代码打包为 DLL 文件存到硬盘里	1.把常用文件存到硬盘/内存里
2.第二次打包时动态链接 DLL 文件，不重新打包	2.第二次加载时直接读取缓存，不重新请求
3.打包时间缩短	3.加载时间缩短

所以在前端世界里， DLL 就是个另类缓存。

2. DLL 手动配置：这么多步根本记不住

刚开始我们先不搞配置，我们设想一下，如果让你手动创建并管理缓存，你会怎么做？

我想，大家的思路一般都是这样的：

第一次请求的时候，把请求后的内容存储起来
建立一个映射表，当后续有请求时，先根据这个映射表到看看要请求的内容有没有被缓存，有的话就加载缓存，没有就走正常请求流程（也就是所谓的缓存命中问题）
命中缓存后，直接从缓存中拿取内容，交给程序处理

主要流程无非这 3 步，想把事情搞大，可以再加些权重啊，过期时间啊，多级缓存什么的，但主要流程就是上面的 3 步。

一般我们在开发的时候，浏览器，http 协议都帮我们把这些操作封装好了，我们就记几个参数调参就行了；但是 webpack dll 不一样，它需要我们手动实现上面 3 个步骤，所以就非常的无聊 + 繁琐。

下面的代码比较乱，因为我也没打算好好讲这些绕来绕去的配置，具体结构最好看我 github 上放出的示例源代码，看不懂也没事，后面有更好的解决方案。

note

看得烦就直接跳过下面的内容

第 1 步，我们先要创建 dll 文件，这个相当于我们对第一次的请求内容进行存储，然后我们还要创建一个映射表，告诉程序我们把啥文件做成 dll 了（这个相当于第 2 步）：

首先我们写一个创建 dll 文件的打包脚本，目的是把 react，react-dom 打包成 dll 文件：

// 文件目录：configs/webpack.dll.js
// 代码太长可以不看

'use strict';

const path = require('path');
const webpack = require('webpack');

module.exports = {
    mode: 'production',
    entry: {
        react: ['react', 'react-dom'],
    },
    // 这个是输出 dll 文件
    output: {
        path: path.resolve(__dirname, '../dll'),
        filename: '_dll_[name].js',
        library: '_dll_[name]',
    },
    // 这个是输出映射表
    plugins: [
        new webpack.DllPlugin({ 
            name: '_dll_[name]', // name === output.library
            path: path.resolve(__dirname, '../dll/[name].manifest.json'),
        })
    ]
};

打包脚本写好了，我们总得运行吧？所以我们写个运行脚本放在 package.json 的 scripts 标签里，这样我们运行 npm run build:dll 就可以打包 dll 文件了：

// package.json

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

第 3 步，链接 dll 文件，也就是告诉 webpack 可以命中的 dll 文件，配置也是一大坨：

// 文件目录：configs/webpack.common.js
// 代码太长可以不看

const path = require('path');
const AddAssetHtmlPlugin = require('add-asset-html-webpack-plugin'); // 顾名思义，把资源加到 html 里，那这个插件把 dll 加入到 index.html 里
const webpack = require('webpack');
module.exports = {
  // ......
  plugins: [
    new webpack.DllReferencePlugin({
      // 注意: DllReferencePlugin 的 context 必须和 package.json 的同级目录，要不然会链接失败
      context: path.resolve(__dirname, '../'),
      manifest: path.resolve(__dirname, '../dll/react.manifest.json'),
    }),
    new AddAssetHtmlPlugin({
      filepath: path.resolve(__dirname, '../dll/_dll_react.js'),
    }),
  ]
}

为了减少一些大型库的二次打包时间，我们在 3 个文件里写了一堆配置代码，小心翼翼，如履薄冰，中间说不定还会因为作用域的问题链接失败（对，说的就是我）。配置 dll 会给人带来巨大的心理阴影，有没有其他方法降低我们的心智负担呢？

3. AutoDllPlugin：解放你的配置负担

在第 2 小节里我疯狂劝退，就是想介绍这个插件：autodll-webpack-plugin，这个插件把上面那 3 坨代码整合到一块儿，让我们摆脱繁琐的配置，让我们看看这么用吧：

// 文件目录：configs/webpack.common.js

const path = require('path');
const AutoDllPlugin = require('autodll-webpack-plugin'); // 第 1 步：引入 DLL 自动链接库插件

module.exports = {
  // ......
  plugins: [
        // 第 2 步：配置要打包为 dll 的文件
        new AutoDllPlugin({
            inject: true, // 设为 true 就把 DLL bundles 插到 index.html 里
            filename: '[name].dll.js',
            context: path.resolve(__dirname, '../'), // AutoDllPlugin 的 context 必须和 package.json 的同级目录，要不然会链接失败
            entry: {
                react: [
                    'react',
                    'react-dom'
                ]
            }
        })
  ]
}

autodll-webpack-plugin 的使用方法和 webpack 的其他 plugin 使用方式非常相似，和手动引入 dll 的方法比起来，简单许多，而且这个插件之前是被 vue-cli 使用的，质量也是比较稳定的，大家可以放心使用。

4. 抛弃 DLL：Vue & React 官方的共同选择

第 3 节我说 autodll-webpack-plugin 之前被 vue-cli 使用，那意思是现在不用了？是不是有 bug 啊？这个还真不是。

学习 webpack 的时候，为了借鉴一下业内优秀的框架的 webpack 配置，我专门看了 vue-cli 和 create-react-app 的源码，但是却没有找到任何 dll 的配置痕迹。

这就很奇怪了，我之前翻过一些 nuxt.js 1.0 的源码，里面是有 dll 的配置代码的，按道理来说 vue-cli 也应该有的，我就猜测是在某次升级中，把 dll 去掉了。所以我开始查找 commit 记录，果然被我找到了：

白纸黑字，remove DLL option 3 个大字写的清清楚楚

原因是什么呢？在这个 issue 里尤雨溪解释了去除的原因：

dll option will be removed. Webpack 4 should provide good enough perf and the cost of maintaining DLL mode inside Vue CLI is no longer justified.
dll 配置将会被移除，因为 Webpack 4 的打包性能足够好的，dll 没有在 Vue ClI 里继续维护的必要了。

同样的，在这个 PR 里 create-react-app 里也给出了类似的解释：webpack 4 有着比 dll 更好的打包性能。

所以说，如果项目上了 webpack 4，再使用 dll 收益并不大。我拿实际项目的代码试了一下，加入 dll 可能会有 1-2 s 的速度提升，对于整体打包时间可以说可以忽略不计。

Vue 和 React 官方 2018 都不再使用 dll 了，现在 2019 年都快过去了，所以说我上面说的都没用了，都不用学了，是不是感觉松了一口气（疯狂暗示点赞）？

5. 比 DLL 更优秀的插件

dll 加速不明显了，有没有更好的替代品？在 AutoDllPlugin 的 README.md 里，给我们推荐了 HardSourceWebpackPlugin，初始配置更简单，只需要一行代码：

const HardSourceWebpackPlugin = require('hard-source-webpack-plugin');

module.exports = {
  // ......
  plugins: [
    new HardSourceWebpackPlugin() // <- 直接加入这行代码就行
  ]
}