vue-cli3 DllPlugin 提取公用庫

vue 開發過程中，保存一次就會編譯一次，如果能夠減少編譯的時間，哪怕是一丁點，也能節省不少時間。開發過程中個人編寫的源文件才會頻繁變動，而一些庫文件我們一般是不會去改動的。如果能把這些庫文件提取出來，就能減少打包體積，加快編譯速度。本文主要講述在 vue-cli3 中利用 DllPlugin 來進行預編譯。

1、安裝相關插件

yarn add webpack-cli@^3.2.3 add-asset-html-webpack-plugin@^3.1.3 clean-webpack-plugin@^1.0.1 --dev

2、編寫配置文件

在項目根目錄下新建 webpack.dll.conf.js，輸入以下內容。

 1 const path = require('path')
 2 const webpack = require('webpack')
 3 const CleanWebpackPlugin = require('clean-webpack-plugin')
 4 
 5 // dll文件存放的目錄
 6 const dllPath = 'public/vendor'
 7 
 8 module.exports = {
 9   entry: {
10     // 需要提取的庫文件
11     vendor: ['vue', 'vue-router', 'vuex', 'axios', 'element-ui']
12   },
13   output: {
14     path: path.join(__dirname, dllPath),
15     filename: '[name].dll.js',
16     // vendor.dll.js中暴露出的全局變數名
17     // 保持與 webpack.DllPlugin 中名稱一致
18     library: '[name]_[hash]'
19   },
20   plugins: [
21     // 清除之前的dll文件
22     new CleanWebpackPlugin(['*.*'], {
23       root: path.join(__dirname, dllPath)
24     }),
25     // 設置環境變數
26     new webpack.DefinePlugin({
27       'process.env': {
28         NODE_ENV: 'production'
29       }
30     }),
31     // manifest.json 描述動態鏈接庫包含了哪些內容
32     new webpack.DllPlugin({
33       path: path.join(__dirname, dllPath, '[name]-manifest.json'),
34       // 保持與 output.library 中名稱一致
35       name: '[name]_[hash]',
36       context: process.cwd()
37     })
38   ]
39 }

3、生成 dll

在 package.json 中加入如下命令

"scripts": {
    ...
    "dll": "webpack -p --progress --config ./webpack.dll.conf.js"
},

控制台運行

yarn run dll

4、忽略已編譯文件

為了節約編譯的時間，這時間我們需要告訴 webpack 公共庫文件已經編譯好了，減少 webpack 對公共庫的編譯時間。在項目根目錄下找到 vue.config.js ( 沒有則新建 )，配置如下:

 1 const webpack = require('webpack')
 2 
 3 module.exports = {
 4     ...
 5     configureWebpack: {
 6         plugins: [
 7           new webpack.DllReferencePlugin({
 8             context: process.cwd(),
 9             manifest: require('./public/vendor/vendor-manifest.json')
10           })
11         ]
12     }
13 }

5、index.html 中載入生成的 dll 文件

經過上面的配置，公共庫提取出來了，編譯速度快了，但如果不引用生成的 dll 文件，網頁是不能正常工作的。

打開 public/index.html，插入 script 標簽。

...
<script src="./vendor/vendor.dll.js"></script>

到此公用庫提取完成，但總覺得最後一部手工插入 script 不太優雅，下麵介紹下如何自動引入生成的 dll 文件。

打開 vue.config.js 在 configureWebpack plugins 節點下，配置 add-asset-html-webpack-plugin

 1 const path = require('path')
 2 const webpack = require('webpack')
 3 const AddAssetHtmlPlugin = require('add-asset-html-webpack-plugin')
 4 
 5 module.exports = {
 6     ...
 7     configureWebpack: {
 8         plugins: [
 9           new webpack.DllReferencePlugin({
10             context: process.cwd(),
11             manifest: require('./public/vendor/vendor-manifest.json')
12           }),
13           // 將 dll 註入到 生成的 html 模板中
14           new AddAssetHtmlPlugin({
15             // dll文件位置
16             filepath: path.resolve(__dirname, './public/vendor/*.js'),
17             // dll 引用路徑
18             publicPath: './vendor',
19             // dll最終輸出的目錄
20             outputPath: './vendor'
21           })
22         ]
23     }
24 }

完。