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

[[226536]]

进入公司之后，接手的便是前人留下来的一个大项目。庆幸的是整个项目拥有完善的产品功能文档，但是由于项目过于庞大，老旧。包含了打包过慢，冗余文件过多等诸多问题。想要快速的解决这些问题，想要完全把功能重构一遍的话，成本太高了。一个一个文件来过，时间成本也比较大。因此在此篇文章中，我们介绍一下我是如何配合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))  
    })  
  })  
}) 

分析第三方依赖

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

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

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

该功能后续也会更新到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.优化方案

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

• CommonsChunkPlugin提取公共代码
• dll-plugin进行大文件单独打包，缓存
• 删除无用的依赖（后面会提到
• 选择性的弃用一些依赖
• 代码压缩
• babel-polyfill
• Scope Hoisting

优化打包时间

针对打包时间的优化的文章其实也很多了，我们在此仅提供一些思路。我们主要提一点，通过构建会发现，项目中引用了大量的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的分析，我们可以直观的拿到以下数据：

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

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

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

原文链接：http://callmedadaxin.github.io/2018/04/13/analyse-project-with-webpack/