我的第一次webpack优化，首屏渲染从9s到1s

vlambda
2022-04-13

我的第一次webpack优化，首屏渲染从9s到1s

链接：https://zhuanlan.zhihu.com/p/476712416

大家好，我是考拉🐨，本文基于vue2(虽然vue3已出，但是本文也很实用)

谈到webpack优化大部分人可能都看腻了，无非就那几招嘛，我之前也是看过许多类似的文章，但都没有自己真正上手过，下面是我用公司的项目真实操练下来的，首屏加载速度提升很大（刷刷的），希望能帮到你。

废话不多说，先看看对比成果！

类型	优化前	优化后
js文件大小	24MB	3MB
主页首屏显示	9s	1s

这简直太夸张了，提升了8倍？可以想象以前是多慢，要等半天啊。蛮王这个真男人都开大2次了~

可以看到，优化前后首屏加载速度有质的提升，之前一直想优化我们项目的首屏加载时间，有缓存还好，没有缓存屏幕白屏都要等待7、8s。特别是有的客户第一次打开这个系统，那7、8秒犹如过了一个世纪，非常尴尬。那么我做了哪些常规操作呢?

1、生产环境关闭`productionSourceMap`、`css sourceMap`

众所周知，SourceMap就是当页面出现某些错误，能够定位到具体的某一行代码，SourceMap就是帮你建立这个映射关系的，方便代码调试。在生产环境中我们完全没必要开启这个功能（谁在生产环境调试代码？不会是你吧）
如下配置：

const isProduction = process.env.NODE_ENV === 'production' 
// 判断是否是生产环境 
module.exports = {     
  productionSourceMap: !isProduction, //关闭生产环境下的SourceMap映射文件 
  css: {         
    sourceMap: !isProduction, // css sourceMap 配置 
    loaderOptions: {             
    ...其它代码         
   }     
  },     
  ...其它代码 
}

此时再npm run build 打包，就会发现速度快了很多，体积瞬间只有几兆了！

2、分析大文件，找出内鬼

安装 npm install webpack-bundle-analyzer -D 插件，打包后会生产一个本地服务，清楚的展示打包文件的包含关系和大小。

vue.config.js 配置：

const BundleAnalyzerPlugin = require('webpack-bundle-analyzer').BundleAnalyzerPlugin  
module.exports = {     
   ...其它     
   configureWebpack: [         
   plugins: [             
      new BundleAnalyzerPlugin() // 分析打包大小使用默认配置 
   ]    
  },  
 ...其它 
}

自动弹出一个服务，清晰的展示打包后js的文件大小：

通过图中可以发现：

element-ui和ant-design占了近1/4的大小：1.53MB。
exceljs也是个大东西有：1.3MB
echarts.js文件也接近1MB
moment.js也有700KB

打包后js文件一共就5MB，这五个哥们就占了4M左右。不分析好还，一分析吓得够呛~
不要虚！找到刺了，一个一个来拔掉就好了。相信我拔掉的过程是很爽的。

一个一个解决，拔刺

把必须要用的第三方js通过cdn的方式引用
分析发现，elementui、echarts是必须使用的，打包又耗时且页面加载也较慢得很。可以通过cdn直接引入，方便且速度快。
element-ui是我们项目用的主要框架，所以这个肯定是少不了，但是项目里面ant-design为什么会存在呢，原来是发现有个页面使用了antd的进度条组件，因为elementui的进度条不太好看。但是没想到这样把整个antd都导进来了。
方案：

舍弃antd组件，自己去找一个类似的vue插件或者干脆自己实现一个。（这个方法短时间无法完成，且不想去动以前代码，暂不考虑）
使用antd部分加载。只加载想要的进度条组件，可以减少文件体积（这个方法简单粗暴，就是牺牲一些文件大小）。

我们使用方案2，根据antd官方的文档配置部分组件的引入。

安装 npm install babel-plugin-import -D

1. main.js导入需要的组件 Step

import { Steps } from 'ant-design-vue'; 
Vue.component(Steps.name, Steps); 
Vue.component(Steps.Step.name, Steps.Step);

2. babel.config.js 加上配置：

module.exports = {  
    presets: [  '@vue/cli-plugin-babel/preset'   ],   
    //以下是按需加载的配置++++ 
    plugins: [     
     [       
      "import",       
      {         
          libraryName: "ant-design-vue",        
          libraryDirectory: "es",         
          style: true       
      }     
     ]   
    ] 
}

此时再分析，antd已经小了很多。

2、使用cdn加载第三方js。

我们项目里面第三方js很多，有些打包下来会很大，而且加载速度较慢。我们把这些js分离出来，通过cdn的方式在html中的script标签中直接使用，一方面减少打包体积，一方面提高了加载速度。

这里推荐一个免费的cdn: BootCDN。也可以使用自己购买的付费cdn服务，我们到网站搜索自己项目需要的js。例如：vue

注意，一定要选择自己项目对应的版本，否则会出现各种奇怪的问题

我的项目使用的是 "vue": "^2.6.12", （package.json）

第一步：配置vue.config.js，让webpack不打包这些js，而是通过script标签加入。

 const isProduction = process.env.NODE_ENV === 'production' // 判断是否是生产环境
//正式环境不打包公共js
let externals = {}
//储存cdn的文件
let cdn = {
    css: [
        'https://cdn.bootcdn.net/ajax/libs/element-ui/2.15.0/theme-chalk/index.min.css' // element-ui css 样式表
    ],
    js: []
}
//正式环境才需要
if (isProduction) {
    externals = { //排除打包的js
        vue: 'Vue',
        'element-ui': 'ELEMENT',
        echarts: 'echarts',
    }
    cdn.js = [
        'https://cdn.bootcdn.net/ajax/libs/vue/2.6.11/vue.min.js', // vuejs
        'https://cdn.bootcdn.net/ajax/libs/element-ui/2.6.0/index.js', // element-ui js
        'https://cdn.bootcdn.net/ajax/libs/element-ui/2.6.0/locale/zh-CN.min.js',
        'https://cdn.bootcdn.net/ajax/libs/echarts/5.1.2/echarts.min.js',
    ]
}
module.exports = {
//...其它配置
configureWebpack: {
        //常用的公共js 排除掉，不打包 而是在index添加cdn，
        externals, 
        //...其它配置
    },
chainWebpack: config => {
        //...其它配置  
        // 注入cdn变量 (打包时会执行)
        config.plugin('html').tap(args => {
            args[0].cdn = cdn // 配置cdn给插件
            return args
        })
    }
//...其它配置     
}

第二步：html模板中加入定义好的cdn变量使用的代码

<!DOCTYPE html>
<html lang="">

<head>
<meta charset="utf-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width,initial-scale=1.0">
    <title>web</title>
    <link rel="icon" href="<%= BASE_URL %>favicon.ico">
    <!-- 引入样式 -->
    <% for(var css of htmlWebpackPlugin.options.cdn.css) { %>
       <link rel="stylesheet" href="<%=css%>" >
    <% } %>

    <!-- 引入JS -->
    <% for(var js of htmlWebpackPlugin.options.cdn.js) { %>
       <script src="<%=js%>"></script>
    <% } %>
</head>
<body style="font-size:14px">
    <section id="app"></section>
</body>
</html>

可以发现cdn.js中，我把vue、echarts、element-ui这三个大头加入了。在externals对象中左侧是npm包的名称，右侧是在代码中暴露的全局变量。注意element-ui对应的是 ELEMENT。

没有ant-design-vue是因为我们上面使用了部分加载的方式，如果使用cdn这种方式是加载全部的代码，有点浪费。

没有使用exclejs，是因为exceljs在我的业务代码中不是直接引用的，而是一个叫table2excel间接依赖的。所以就算我通过上面的方法排除掉它，在打包的时候还是会通过table2excel的依赖找到它并打包。
那这种不可避免的情况，该如何优化，让加载速度不受影响呢？

答案是通过懒加载的方式：

1.script标签中注释掉 import Table2Excel from "table2excel.js";
2.下载的方法中：download(){

1.script标签中注释掉 import Table2Excel from "table2excel.js";

2.下载的方法中：
download(){
    //使用import().then()方式
    import("table2excel.js").then((Table2Excel) => {
        new Table2Excel.default("#table").export('filename') //多了一层default 
    })
}

这样在进入系统时，不会加载Table2Excel 和exceljs，当需要时才会去加载，第一次会慢一点，后面就不需要加载了，会变快。

3 moment.js的优化

我们发现monentjs在项目中有使用来对时间格式化，但是使用频率并不高，完全可以自己实现一个format方法，或者使用只有6kb的day.js.

但这里我们暂不替换，把moment变得瘦小一些即可，删除掉除中文以外的语言包。
第一步：**vue.config.js**

...其它配置
 chainWebpack: config => {
     config.plugin('ignore')
        //忽略/moment/locale下的所有文件
     .use(new webpack.IgnorePlugin(/^\.\/locale$/, /moment$/))
 }
...其它配置

第二步：main.js

import moment from 'moment' //手动引入所需要的语言包 
import 'moment/locale/zh-cn'; // 指定使用的语言 
moment.locale('zh-cn');

这次我们看看moment打包后多大：

只有174kb了。不过，有一说一还是day.js香~
做完上面这些动作我们的js文件总大小：3.04MB ，其中包含 1.3MB的懒加载js，剩下的1.7MB左右的js基本上不会对页面造成很大的卡顿。

还有进步空间？
1.通过 compression-webpack-plugin 插件把代码压缩为gzip。但是！需要服务器支持
webpack端 vue.config.js配置如下：

//打包压缩静态文件插件
const CompressionPlugin = require("compression-webpack-plugin")

//...其它配置
module.exports = {
    //...其它配置
    chainWebpack: config => {
        //生产环境开启js\css压缩
        if (isProduction) {
            config.plugin('compressionPlugin').use(new CompressionPlugin({
                test: /\.(js)$/, // 匹配文件名
                threshold: 10240, // 对超过10k的数据压缩
                minRatio: 0.8,
                deleteOriginalAssets: true // 删除源文件
            }))
        }
    }
    //...其它配置
}