借助webpack对项目进行分析优化

2,191 阅读6分钟
进入公司之后,接手的便是前人留下来的一个大项目。庆幸的是整个项目拥有完善的产品功能文档,但是由于项目过于庞大,老旧。包含了打包过慢,冗余文件过多等诸多问题。想要快速的解决这些问题,想要完全把功能重构一遍的话,成本太高了。一个一个文件来过,时间成本也比较大。因此在此篇文章中,我们介绍一下我是如何配合webpack一步步进行分析,将项目进行优化的。
同时我针对思路封装了一个webpack-unused-files,用于查找项目中的冗余文件,欢迎试用并star
原文链接

问题

首先,我们先大致看下我们都有什么问题,然后一步步进行解决

  • 项目频繁进行修改,冗余文件过多
  • 部分第三方依赖滥用,想去除但是不知道在哪个文件中。或没用,但是遗留在package.json里,
  • 项目庞大,打包的结果过大,时间过长

删除冗余文件

由于项目的频繁改动,有很多文件已经不被使用并且没有被删除。由于项目的不断扩大,只会影响我们定位功能和问题的速度,因此对冗余文件进行清理,是很重要的。但是我们单凭肉眼很难识别哪个文件是否被依赖的,因此还要通过webpack来解决。

1.获取项目依赖的所有文件

我们来看一下webpack的输出文件格式:

{
  ...
  chunks: [{
    name: 'chunk-name',
    modules: [
      // 每个chunk中所有的依赖文件
    ]
  }]
  ...
}

所以说,根据这个stats.json,我们可以拿到在整个项目中拿到的所有项目文件:

/**
 * 查询依赖的模块
 */
function findSrcModules () {
  return new Promise((resolve, reject) => {
    fs.readFile(statPath, (err, data) => {
      if (err) return
      const json = JSON.parse(data)
      const assetsList = json.chunks
      let ret = []
      // 拿到所有chunk的所有依赖文件
      assetsList.forEach(chunk => {
        const modules = chunk.modules.map(item => item.name)
        ret = ret.concat(modules)
      })
      // 去除node_modules中的文件
      ret = ret.filter(item => item.indexOf('node_modules') < 0)
      resolve(ret)
    })
  })
}

通过这一步,我们可以拿到项目中,所有打包依赖的文件。

2.获取项目中所有的文件

通过glob,我们可以获取所有的文件:

function getAllFilesInSrc () {
  const pattern = './src/**'

  return new Promise((resolve, reject) => {
    glob(pattern, {
      nodir: true
    }, (err, files) => {
      const ret = files.map(item => {
        return item.replace('./src', '.')
      })
      resolve(ret)
    })
  })
}

3.将两个文件数组进行对比,然后进行删除等操作:

将两个数组进行对比,没有出现在依赖中的文件,就是冗余文件。我们可以一键删除

findSrcModules().then(ret => {
  getAllFilesInSrc().then(allFiles => {
    const unUsed = allFiles.filter(item => {
      return ret.indexOf(item) < 0
    })
    const join = p => path.join('./src', p)

    unUsed.forEach(file => {
      shelljs.rm(join(file))
    })
  })
})

分析第三方依赖

根据上述冗余文件的思路,我们同样可以对第三方依赖进行处理,大致思路如下

  1. 获取所有包含node_modules的依赖
  2. 将文件名进行截取、去重。获取到所有的依赖
  3. 与package.json进行对比,拿到没有使用的依赖
  4. 将对比结果进行分析,将不想使用的依赖保存下来
  5. 再次查找stat.json,查找该依赖的reson字段,获取再哪里引用了该依赖,进行输出
  6. 将依赖进行手动替换、删除等操作

可以说,拿到了所有依赖及依赖关系,我们可以很灵活的对其进行处理,拿到我们想要的结果。

该功能后续也会更新到webpack-unused-files中去。

优化打包大小

让人震惊的是,整个项目由于种种原因,打包后的大小有近20M的大小!虽然并不是TO C项目,并且针对页面进行了代码拆分和懒加载,但是作为一个“合格的前端”,这种现象是一定要修改的(没错!)。该如何下手呢?一个个的翻代码,看看我们都引用了什么大依赖,看哪些项目过大未免太复杂了。我们看看webpack给我吗提供了什么方案:

1.展示打包结果

我们知道,在webpack打包结束后,会自动在控制台显示打包结果。同时,他也提供了输出依赖及大小的功能,我们执行以下参数, 便可将所有的依赖进行展示,并且看到他们的大小了。

webpack --display-modules --sort-modules-by size

结果类似这样:

我们可以很快的定位到排名前几的js文件或者第三方依赖,决定该如何对其进行处置。

2.可视化分析依赖

webpack提供了一个功能,将打包的所有依赖文件以及关系,以json格式进行输出:

webpack --profile --json > stats.json

这是我们整篇文章的一个基础,很多人基于此封装了不少可视化分析的工具,可以直观的看到各个文件、chunk之间的依赖关系以及大小等,快速定位到大文件、大模块

webpack analyse

webpack chart

3.优化方案

通过以上两种方法,我们可以很好的对内容文件和依赖进行定位和分析,针对打包大小的优化方案网上已经有很多了,在此不再进行赘述,提供几个思路及参考:

优化打包时间

针对打包时间的优化的文章其实也很多了,我们在此仅提供一些思路。我们主要提一点,通过构建会发现,项目中引用了大量的svg图标以及国旗图标,每次在静态资源处理中,打包时间就会变的特别慢。

我们在项目中使用的svg-sprite-loader,自动将各个svg图标进行svg-spirte。但是我们知道,这些图标一旦引用,我们很少进行修改。尤其是像国旗图标这种,但是每次构建我们都需要进行重复打包。因此,我们可以提前把这些图标进行svg-sprite。推荐一个网站,将各种svg图标提前进行sprite并自动进行引用:

iconmoon

日常打包时间优化点

  • externals 避免打包大的第三方依赖
  • dll-plugin 预打包第三方依赖
  • happypack 多进程处理,缓存
  • 缓存与增量构建

    • babel-loader?cacheDirectory
    • webpack cache:true
  • 减少构建搜索或编译路径 alias resolve
  • 具象打包的范围 include exclude

总结

通过对webpack输出依赖关系的json的分析,我们可以直观的拿到以下数据:

  • 所有依赖文件及其大小
  • 每个依赖文件是被哪些文件引用的
  • 项目依赖的第三方依赖

通过这些数据,我们可以很方便的对现有项目进行优化。

生命不息,倒腾不止。让我们对所有的恶心代码说再见!