欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

webpack 代码分离优化快速指北

程序员文章站 2023-11-28 13:51:16
分离代码文件 在此之前,首先要知道经常配置的 output 中有关 filename 和 chunkfilename 的区别;简单来说在 entry 定义的入口文件走...

分离代码文件

在此之前,首先要知道经常配置的 output 中有关 filename 和 chunkfilename 的区别;简单来说在 entry 定义的入口文件走的就是 filename 配置项,在入口文件内部引入的通常情况下是 chunk,走 chunkfilename 的配置

所以很多时候分离代码文件就是将不同的 chunk 分离开来,生产环境中有利于浏览器缓存,加快二次访问的速度

代码分离的时候,optimization 中配置的 splitchunks 默认就是 async,默认对异步代码进行分离;所以通常情况下能用异步的用异步 import;配合 prefetching 和 preloading 能够产生很好的效果

filename 和 chunkfilename 的区别

output: {
 filename: '[name].js',
 chunkfilename: '[name].chunk.js'
}

举个例子

如果入口文件是 main.js

那么打包后生成的文件是 main.js

如果 main.js 中引入了其他模块,比如引入了 lodash 那么可能会生成一个名为 lodash.chunk.js 文件

基本概念了解了,接下来开始对 js 和 css 文件进行分离的操作:

js 代码分离

js 代码的分离操作,首先要考虑的就是对异步代码的分离。这里使用 dynamicimport

dynamicimport

可以使用 magic comment 来修改动态 import 导出的 chunkname,语法规则如下:

import('/* webpackchunkname: "lodash" */' 'lodash').then(//...)

如果需要使用这种注释的写法,应该安装模块 @babel/plugin-syntax-dynamic-import,并在 babelrc 中引入这个插件,使用方法很简单这里不多说了

splitchunks

splitchunk 的相关配置参数

建议将公共使用的第三方类库显式地配置为公共的部分,而不是 webpack 自己去判断处理

  • chunks: 表示显示块的范围,有三个可选值:initial(初始块)、async(按需加载块)、all(全部块),默认为all;
  • minsize: 表示在压缩前的最小模块大小,默认为0;
  • minchunks: 表示被引用次数,默认为1;
  • maxasyncrequests: 最大的按需(异步)加载次数,默认为1;
  • maxinitialrequests: 最大的初始化加载次数,默认为1;
  • name: 拆分出来块的名字(chunk names),默认由块名和hash值自动生成;
  • cachegroups: 缓存组。

缓存组中还有其他几个参数:

  • priority: 表示缓存的优先级;
  • test: 缓存组的规则,表示符合条件的的放入当前缓存组,值可以是function、boolean、string、regexp,默认为空;
  • reuseexistingchunk: 表示可以使用已经存在的块,即如果满足条件的块已经存在就使用已有的,不再创建一个新的块。

webpack4——splitchunksplugin使用指南

module.exports = {
 entry: {
 vendor: ["react", "lodash", "angular", ...], // 指定公共使用的第三方类库
 },
 optimization: {
 splitchunks: {
  cachegroups: {
  vendor: {
   chunks: "initial",
   test: "vendor",
   name: "vendor", // 使用 vendor 入口作为公共部分
   enforce: true,
  },
  },
 },
 },
 // ... 其他配置
}

或者:

optimization: {
 splitchunks: {
  name: true, // 自动处理文件名
  chunks: 'all',
  minchunks: 1, // 至少 import 1 次的即需要打包
  automaticnamedelimiter: '-',
  cachegroups: {
  vendors: {
   test: /axios|lodash/, // 将这两个第三方模块单独提取打包
   chunks: 'initial',
  }
  }
 }
 },

chunks 的配置

注意 ⚠️

如果是动态 import,import('/* webpackchunkname: "lodash" */' 'lodash').then() 那么 splitchunks 设置为 async,代码分离将会起作用。

如果是同步加载 import, import _ from 'lodash' 那么 splitchunks 设置为 async 将不起作用,如果设置为 all,那么还需要配置 cachegroups

cachegroups 的配置

vendors 缓存组的配置可以检测第三方模块是否在 node_modules 中,如果存在则该 splitchunks 生效,将会分离到 vendors~... 这样的文件中

配置 filename 则会打包成 [filename] 命名的文件中

runtimechunk 的作用

这个 runtimechunk 实际上就是链接业务逻辑和第三方类库之间的关系的 manifest。需要将其提取出来,否则使用 contenthash 的情况下有可能会导致模块内容没发生改变的情况下出现 contenthash 多次打包出现不一致的情况(实际上就是存在在业务逻辑和模块中的 manifest 发生了改变)

// v4版本的 webpack 不用配置,但最好也提取出来
optimization: {
 runtimechunk: {
 name: 'runtime'
 }
}

reuseexistingchunk:

如果 a 模块使用了 b,b 模块又使用了 a;a 被打包到 common.js 中,打包 b 时将直接使用已经打包好的 common.js 中的 a;这就是 reuseexistingchunk 的作用:

default: {
 reuseexistingchunk: true,
 filename: 'common.js'
}

他的含义就是只要其中一个模块使用了 import $ from 'jquery',其他文件中就可直接使用 $ 变量,webpack 会自动在打包过程中 import 这个模块

css 代码分离

css 部分分离代码文件 直接使用 extract-text-webpack-plugin 即可

一个 js 文件,加载页面时虽然只需要加载一个 js 文件,但代码一旦改变,用户访问新的页面时就需要重新加载一个新的 js 文件。有些情况下,我们只是单独修改了样式,这样也要重新加载整个应用的 js 文件,相当不划算。
多个组件共用一部分样式,如果分离开来,第二个页面就有了 css 文件的缓存,访问速度自然会加快

minicssextractplugin

新版本的 webpack 使用这个插件

注意,在引入样式文件 import './style.css' 的时候,如果配置了 treeshaking,应当在 package.json 中配置:

"sideeffects": [
 "*.css"
]

⚠️ 注意,另外在 vue 中如果有 style 标签,还需要在 sideeffects 中加入 *.vue 的配置项。不必担心 vue 中的 script 部分会被 treeshaking 掉。

插件的相关配置

filename 指的是如果该 css 文件会直接被插入 html 中那么走的就是 filename 的配置

plugins: [
 new minicssextractplugin({
 filename: '[name].css',
 chunkfilename: '[name].chunk.css'
 })
]

既然有分离那就有合并,这里顺便提及一下 css 代码合并

如果有多个入口,想把多个入口引入的样式文件全部打包到一个地方,那么可以使用 optimization 配置项的 splitchunks,所以这个配置项不仅仅只作用于 js,css 也是可以的:

optimization: {
 splitchuns: {
 cachegroups: {
  styles: {
  name: 'style', // 将多个入口文件中的样式文件全部合并打包
  test: /\.css$/,
  chunks: 'all',
  enforce: true
  }
 }
 }
}

css 代码根据入口分别打包

还可以根据入口的不同,来分别打包 css 文件,文档已经讲的很详细了,这部分比较简单可以直接戳文档

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。