高级篇:webpack应用指南二


根据尚硅谷视频教程及webpack5官网部分内容整理。
尚硅谷Web前端之Webpack5教程文档
Webpack中文官网

减少代码体积

减少Babel生成文件的体积*

Babel为编译的每个文件都插入了辅助代码,使代码体积过大。Babel对一些公共方法使用了非常小的辅助代码,比如 _extend。默认情况下会被添加到每一个需要它的文件中。所以可以将这些辅助代码作为一个独立模块,来避免重复引入。
使用插件@babel/plugin-transform-runtime,该插件禁用了Babel自动对每个文件的runtime注入,引入@babel/plugin-transform-runtime并且使所有辅助代码从这里引用。配置时在babel-loader的“plugins”属性中引入该插件,配置方式如下。
安装插件@babel/plugin-transform-runtimenpm i @babel/plugin-transform-runtime -D

// webpack.dev.js/webpack.prod.js
...

module.exports = {...},
  // 模块
  module: {
    rules: [
      {
        oneOf: [
          {...},
          {...},
          {...},
          {...},
          {
            test: /\.m?js$/,
            exclude: /(node_modules|bower_components)/,
            use: [
              {
                loader: "thread-loader", // 开启多进程
                options: {
                  workers: threads, // 数量
                },
              },
              {
                loader: 'babel-loader',
                options: {
                  cacheDirectory: true, // 开启babel编译缓存
                  cacheCompression: false, // 缓存文件不要压缩
                  plugins: ['@babel/plugin-transform-runtime'], // 减少babel体积
                }
              },
            ]
          }
        ]
      }
    ]
  },
  ...
};

压缩图片【生产环境】

开发如果项目中引用了较多图片,那么图片体积会比较大,将来请求速度比较慢。可以对图片进行压缩,减少图片体积。
注意:如果项目中图片都是在线链接,那么就不需要了。本地项目静态图片才需要进行压缩。
image-minimizer-webpack-plugin:用来压缩图片的插件。
安装:npm i image-minimizer-webpack-plugin imagemin -D
此外,还需要其他依赖包进行下载,分为无损模式和有损模式。

  • 无损压缩:npm install imagemin-gifsicle imagemin-jpegtran imagemin-optipng imagemin-svgo -D
  • 有损压缩:npm install imagemin-gifsicle imagemin-mozjpeg imagemin-pngquant imagemin-svgo -D
    以无损模式配置为例,配置方式如下。
// webpack.prod.js
...
// 引入图片压缩文件
const ImageMinimizerPlugin = require("image-minimizer-webpack-plugin");

const threads = os.cpus().length-1;

function getCommonStyleSets(pre) {...}

module.exports = {
  // 入口
  entry: './src/main.js',
  // 输出
  output: {...},
  // 模块
  module: {...},
  // 插件
  plugins:[...],
  optimization: {
    // 告知 webpack 使用 TerserPlugin 或其它在 optimization.minimizer定义的插件压缩 bundle。
    minimize: true,
    // 允许通过提供一个或多个定制过的 TerserPlugin 实例,覆盖默认压缩工具(minimizer)。
    minimizer: [
      // css压缩也可以写到optimization.minimizer里面,效果一样的
      new CssMinimizerPlugin(),
      // 当生产模式会默认开启TerserPlugin,但是我们需要进行其他配置,就要重新写了
      new TerserPlugin({
        parallel: threads // 开启多进程
      }),
      // 配置图片压缩
      new ImageMinimizerPlugin({
        minimizer: {
          implementation: ImageMinimizerPlugin.imageminGenerate,
          options: {
            plugins: [
              ["gifsicle", { interlaced: true }],
              ["jpegtran", { progressive: true }],
              ["optipng", { optimizationLevel: 5 }],
              [
                "svgo",
                {
                  plugins: [
                    "preset-default",
                    "prefixIds",
                    {
                      name: "sortAttrs",
                      params: {
                        xmlnsOrder: "alphabetical",
                      },
                    },
                  ],
                },
              ],
            ],
          },
        },
      }),
    ],
  },
  // 模式
  mode: 'production',
  devtool: 'source-map'
};

打包时如果出现报错,很可能是下载依赖包时下载失败,缺少执行文件,比如jpegtran.exeoptipng.exe等,具体请查看报错信息。可取相应官网地址手动下载缺少的文件,并放置到对应位置。
jpegtran 官网地址OptiPNG 官网地址

优化代码运行性能

Code Split

打包代码时会将所有js文件打包到一个文件中,体积很大。如需要渲染首页内容,就应该只加载首页的js文件,其他文件不应该加载。所以需要将打包生成的文件进行代码分割,生成多个js文件,渲染哪个页面就只加载某个js文件,这样加载的资源就少,速度就更快。
代码分割(Code Split)主要做了两件事:

  • 分割文件:将打包生成的文件进行分割,生成多个js文件。
  • 按需加载:需要哪个文件就加载哪个文件。

多入口文件

当项目有多个入口文件时,需要打包生成多个入口文件。如下所示

entry: {
  main: "./src/main.js",
  app: "./src/app.js",
},

打包后会生成两个入口文件,文件名称我们可以使用自定义,例如[name],如下所示:

// webpack.config.js
const path = require("path");
const HtmlWebpackPlugin = require("html-webpack-plugin");

module.exports = {
  // 多入口
  entry: {
    main: "./src/main.js",
    app: "./src/app.js",
  },
  output: {
    path: path.resolve(__dirname, "./dist"),
    // [name]是webpack命名规则,使用chunk的name作为输出的文件名。
    // 什么是chunk?打包的资源就是chunk,输出出去叫bundle。
    // chunk的name是啥呢? 比如: entry中xxx: "./src/xxx.js", name就是xxx。注意是前面的xxx,和文件名无关。
    // 为什么需要这样命名呢?如果还是之前写法main.js,那么打包生成两个js文件都会叫做main.js会发生覆盖。(实际上会直接报错的)
    filename: "js/[name].js",
    clear: true,
  },
  plugins: [...],
  mode: "production",
};
提取重复代码

当多入口文件中都引用了同一份代码,我们不希望这份代码被重复打包到两个文件中,导致代码重复,体积更大。此时我们需要提取多入口的重复代码,只打包生成一个js文件,其他文件引用它就好。
例如,入口文件app.jsmain.js中都引用了math.js文件,我们需要在webpack配置文件中配置splitChunks属性避免重复打包,如下所示。

...

module.exports = {
  // 多入口
  entry: {
    main: "./src/main.js",
    app: "./src/app.js",
  },
  output: {...},
  plugins: [...],
  mode: "production",
  optimization: {
    // 代码分割配置
    splitChunks: {
      chunks: "all", // 对所有模块都进行分割
      // 以下是默认值
      // minSize: 20000, // 分割代码最小的大小
      // minRemainingSize: 0, // 类似于minSize,最后确保提取的文件大小不能为0
      // minChunks: 1, // 至少被引用的次数,满足条件才会代码分割
      // maxAsyncRequests: 30, // 按需加载时并行加载的文件的最大数量
      // maxInitialRequests: 30, // 入口js文件最大并行请求数量
      // enforceSizeThreshold: 50000, // 超过50kb一定会单独打包(此时会忽略minRemainingSize、maxAsyncRequests、maxInitialRequests)
      // 修改配置
      cacheGroups: {
        // 组,哪些模块要打包到一个组
        // defaultVendors: { // 组名
        //   test: /[\\/]node_modules[\\/]/, // 需要打包到一起的模块
        //   priority: -10, // 权重(越大越高)
        //   reuseExistingChunk: true, // 如果当前 chunk 包含已从主 bundle 中拆分出的模块,则它将被重用,而不是生成新的模块
        // },
        default: {
          // 其他没有写的配置会使用上面的默认值
          minSize: 0, // 我们定义的文件体积太小了,所以要改打包的最小文件体积
          minChunks: 2,
          priority: -20,
          reuseExistingChunk: true,
        },
      },
    },
  },
};
按需动态加载

想要实现按需加载,动态导入模块。还需要额外配置。所谓按需加载,是指页面加载仅加载需要呈现的内容,对于按钮或者其他不需要初始化加载的js文件等,可配置动态加载模式,仅在触发时加载。如下所示。

// main.js
console.log("hello main");

document.getElementById("btn").onclick = function () {
  // 动态导入 --> 实现按需加载。该方法是按钮btn上的onClick事件,无需初始化时加载。
  // 即使只被引用了一次,也会代码分割
  import("./math.js").then(({ sum }) => {
    alert(sum(1, 2, 3, 4, 5));
  });
};

单入口

开发时如果是单页面应用(SPA),只有一个入口(单入口)。可进行如下配置。

// webpack.prod.js
...

function getCommonStyleSets(pre) {...}

module.exports = {
  ...
  optimization: {
    ...
    splitChunks:{
      chunks: "all"
      // 其他取默认值,或者自行配置
    }
  },
  ....
};

自定义按需动态导入文件名称

对于按需导入的文件,可使用webpackChunkName: name的方式自定义文件名称。如下所示

// main.js
import count from "./js/count";
import sum from './js/sum';
import { cube } from './js/math';
// 需要引入才能被打包
import './css/index.css';
import './less/index.less';

console.log(count(1,2));
console.log(sum(1,2,3,4));
console.log(cube(3));

// 判断是否开启热模块替换
if(module.hot){
  // 有回调函数
  module.hot.accept('./js/count.js',function(){
    const result1 = count(2, 1);
    console.log("new ",result1);
  });
  // 无回调函数
  module.hot.accept('./js/sum.js');
}

document.getElementById("btn").onclick = function() {
  // webpackChunkName: "math":这是webpack动态导入模块命名的方式
  import(/* webpackChunkName:"newtest" */"./js/newTest.js").then(({ sums }) => {
    console.log(sums(1,2,3))
  });
}

统一命名配置名称

对于打包的图片、字体等asset/resource文件可使用assetModuleFilename属性进行统一配置,可省略loader中配置的generator属性。同样对于chunk类的分割打包文件可使用chunkFilename进行区分配置,如下所示。

// webpack.prod.js
...

function getCommonStyleSets(pre) { ... }

module.exports = {
  // 单入口
  entry: './src/main.js',
  // 输出
  output: {
    path: path.resolve(__dirname, '../dist'),
    // js资源
    filename: 'static/js/main.js',
    chunkFilename: "static/js/[name].chunk.js", // 动态导入输出资源命名方式
    assetModuleFilename: "static/media/[name].[hash][ext]", // 图片、字体等资源命名方式(注意用hash)
    // 在打包前,将dist目录整个清空
    clean: true
  },
  // 模块
  module: {
    rules: [
      {
        // oneOf实现只匹配一项loader,剩余loader不再匹配
        oneOf: [
          {...},
          {...},
          {
            test: /\.(png|svg|jpg|jpeg|gif)$/i,
            type: 'asset',
            parser: {
              dataUrlCondition: {
                maxSize: 15 * 1024 // 小于15kb使用base64格式,其他引用图片路径
              }
            },
            // generator: {
            //   // 控制图片输出路径及文件名称
            //   filename: 'static/imags/[hash:8][ext][query]'
            // }
          },
          {
            test: /\.(ttf|woff2?)$/,
            type: "asset/resource",
            // generator: {
            //   filename: "static/media/[hash:8][ext][query]",
            // },
          },
          {...}
        ]
      }
    ]
  },
  // 插件
  plugins:[...],
  optimization: {...},
  // 模式
  mode: 'production',
  devtool: 'source-map'
};

Preload / Prefetch

虽然前面已经做了代码分割,同时会使用import动态导入语法来进行代码按需加载(也叫懒加载,比如路由懒加载就是这样实现的)。但是加载速度可能会有问题,比如:是用户点击按钮时才加载这个资源的,如果资源体积很大,加载速度慢,那么用户会感觉到明显卡顿效果。想在浏览器空闲时间,加载后续需要使用的资源。就需要用上PreloadPrefetch技术。

  • Preload:告知浏览器立即加载资源。
  • Prefetch:告知浏览器在空闲时才开始加载资源。
    共同点:都只会加载资源,并不执行。且都有缓存。
    区别:Preload加载优先级高,Prefetch加载优先级低。Preload只能加载当前页面需要使用的资源,Prefetch可以加载当前页面资源,也可以加载下一个页面需要使用的资源。
    问题:兼容性较差,Preload相对于Prefetch兼容性好一点。参考网站:Can I Use
    配置如下。
    安装包:npm i @vue/preload-webpack-plugin -D
    配置 webpack.prod.js
// webpack.prod.js
...
// preload插件
const PreloadWebpackPlugin = require("@vue/preload-webpack-plugin");

const threads = os.cpus().length-1;

function getCommonStyleSets(pre) { ... }

module.exports = {
  ...
  // 模块
  module: {...},
  // 插件
  plugins:[
    ...
    new PreloadWebpackPlugin({
      rel: "preload", // preload兼容性更好
      as: "script",
      // rel: 'prefetch' // prefetch兼容性更差
    }),
  ],
  optimization: {...},
  // 模式
  mode: 'production',
  devtool: 'source-map'
};

Network Cache

项目开发时对静态资源会使用缓存来优化,浏览器第二次请求资源会读取缓存,速度很快。但是这样的话就会有一个问题, 因为前后输出的文件名是一样的,例如都叫main.js,一旦将来发布新版本,因为文件名没有变化导致浏览器会直接读取缓存,不会加载新资源,项目也就无法更新。所以需要确保更新前后文件名不一样,以便读取最新的文件内容。

  • fullhashwebpack4hash
    每次修改任何一个文件,所有文件名的 hash 至都将改变。所以一旦修改了任何一个文件,整个项目的文件缓存都将失效。
  • chunkhash
    根据不同的入口文件(Entry)进行依赖文件解析、构建对应的chunk,生成对应的哈希值。我们jscss是同一个引入,会共享一个hash值。
  • contenthash
    根据文件内容生成hash值,只有文件内容变化了,hash值才会变化。所有文件hash值是独享且不同的。
    webpack配置文件配置内容如下。
// webpack.prod.js
function getCommonStyleSets(pre) {...}

module.exports = {
  ...
  // 输出
  output: {
    path: path.resolve(__dirname, '../dist'),
    // js资源
    // [contenthash:8]使用contenthash,取8位长度
    filename: 'static/js/main.[contenthash:8].js',
    chunkFilename: "static/js/[name].[contenthash:8].chunk.js", // 动态导入输出资源命名方式
    assetModuleFilename: "static/media/[name].[hash][ext]", // 图片、字体等资源命名方式(注意用hash)
    // 在打包前,将dist目录整个清空
    clean: true
  },
  // 模块
  module: {...},
  // 插件
  plugins:[
   ...
    new MiniCssExtractPlugin({
      // 定义输出的文件名和目录
      filename: 'static/css/[name].[contenthash:8].css',
      chunkFilename: "static/css/[name].[contenthash:8].chunk.css",
    }),
    ...
  ],
  ...
};

但以上依旧会产生一个问题,例如main.js中引用了math.js文件。当修改了math.js文件再重新打包的时候,因为contenthash原因,math.js文件hash值发生了变化(这是正常的)。但是main.js文件的hash值也发生了变化,这会导致main.js的缓存失效。(因为main.js中引用了math.js,所以打包时由于math文件额hash值发生变化,导致main.js内容也发生了变化)。
解决方法是将hash值单独保管在一个runtime文件中。
最终会输出三个文件:mainmathruntime。当math文件发送变化,变化的是mathruntime文件,main不变。runtime文件只保存文件的hash值和它们与文件的映射关系,整个文件体积就比较小,所以变化重新请求的代价也小。
webpack配置方法如下。

// webpack.prod.js
function getCommonStyleSets(pre) {...}

module.exports = {
 ...
  optimization: {
    ...
    splitChunks:{
      chunks: "all"
      // 其他取默认值,或者自行配置
    },
    // 提取runtime文件
    runtimeChunk: {
      name: (entrypoint) => `runtime~${entrypoint.name}`, // runtime文件命名规则
    },
  },
  ...
};

Core-js

以上使用babeljs代码进行了兼容性处理,其中使用@babel/preset-env智能预设来处理兼容性问题。它能将ES6的一些语法进行编译转换,比如箭头函数、扩展运算符等。但是如果是async函数、promise对象、数组的一些方法(includes)等,它没办法处理。所以此时js代码仍然存在兼容性问题,一旦遇到低版本浏览器会直接报错。所以仍需要解决js代码的部分兼容性问题。
core-js是专门用来做ES6以及以上APIpolyfillpolyfill翻译过来叫做垫片/补丁。就是用社区上提供的一段代码,让我们在不兼容某些新特性的浏览器上,使用该新特性。
下载并应用corejs包。
安装:npm i core-js

  • 手动全部引入
import "core-js";

// 添加promise代码
const promise = Promise.resolve();
promise.then(() => {
  console.log("hello promise");
});

但这样引入会将所有兼容性代码全部引入,体积太大了。我们只想引入promisepolyfill。如下所示。

import "core-js/es/promise";

// 添加promise代码
const promise = Promise.resolve();
promise.then(() => {
  console.log("hello promise");
});

只引入打包promisepolyfill,打包体积更小。但是将来如果还想使用其他语法,需要手动引入库很麻烦。可配置自动按需引入。

  • 自动按需引入
// 不需要手动按需引入

// 添加promise代码
const promise = Promise.resolve();
promise.then(() => {
  console.log("hello promise");
});

配置babel配置文件。

// babel.config.js
module.exports = {
  presets: [
    [
      '@babel/preset-env',
      // 按需加载core-js的polyfill
      { useBuiltIns: "usage", corejs: { version: "3", proposals: true } },
    ]
  ]
}

此时就会自动根据代码中使用的语法,来按需加载相应的polyfill

PWA

开发Web App项目,项目一旦处于网络离线情况,就没法访问了。PWA可以给项目提供离线体验。
渐进式网络应用程序(progressive web application - PWA):是一种可以提供类似于native app(原生应用程序) 体验的Web App的技术。其中最重要的是,在离线(offline) 时应用程序能够继续运行功能。内部通过Service Workers技术实现的。配置方法如下。
安装依赖包:npm i workbox-webpack-plugin -D
修改webpack配置文件。

// webpack.prod.js

function getCommonStyleSets(pre) {...}

module.exports = {
  ...
  // 插件
  plugins:[
    ...
    // 离线处理
    new WorkboxPlugin.GenerateSW({
      // 这些选项帮助快速启用 ServiceWorkers
      // 不允许遗留任何“旧的” ServiceWorkers
      clientsClaim: true,
      skipWaiting: true,
    }),
  ],
  ...
};

但此时如果直接通过VSCode访问打包后页面,在浏览器控制台会发现SW registration failed
因为我们打开的访问路径是:http://127.0.0.1:5500/dist/index.html。此时页面会去请求service-worker.js文件,请求路径是:http://127.0.0.1:5500/service-worker.js,这样找不到会导致404
实际service-worker.js文件路径是:http://127.0.0.1:5500/dist/service-worker.js

  • 解决路径问题
    安装依赖包:npm i serve -gserve也是用来启动开发服务器来部署代码查看效果的。
    运行指令:serve dist。此时通过serve启动的服务器我们service-worker就能注册成功了。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值