webpack5 动态导入实现按需加载与统一文件命名配置

作者:阿沐时间:2026-10-25 23:30:30浏览:548

本文介绍如何在webpack5中通过import()实现模块的按需加载,解决打包后文件名随机问题。通过配置output.chunkFilename并结合webpackChunkName注释,可统一输出文件的命名规则。同时涵盖eslint兼容配置及Preload/Prefetch优化建议,提升大型资源加载体验。

webpack5 动态导入与按需加载配置

为了实现模块的按需加载,可以使用动态导入方式,并需要额外进行相关配置。

console.log("hello main");
 
document.getElementById("btn").onClick = function () {
   // 动态导入 --> 实现按需加载  -->then是加载成功要做的处理不处理的话可以不写
 
  import( "./js/math.js").then(({ count }) => {
    console.log(count(2, 1));
  });
};

具体效果如下所示:

webpack5 动态导入与按需加载配置

若未配置命名规则,打包生成的文件名将呈现为随机字符串。

1. 修改配置文件

main.js

console.log("hello main");
 
document.getElementById("btn").onClick = function () {
   // 动态导入 --> 实现按需加载  -->then是加载成功要做的处理不处理的话可以不写
  // eslint会对动态导入语法报错,需要修改eslint配置文件
  // webpackChunkName: "math":这是webpack动态导入模块命名的方式
  // "math"将来就会作为[name]的值显示。
  import(/* webpackChunkName: "math" */ "./js/math.js").then(({ count }) => {
    console.log(count(2, 1));
  });
};

eslint 配置

// .eslintrc.js
module.exports = {
  // 继承 Eslint 规则
  extends: ["eslint:recommended"],
  env: {
    node: true, // 启用node中全局变量
    browser: true, // 启用浏览器中全局变量
  },
 // 解决动态导入import语法报错问题 --> 实际使用eslint-plugin-import的规则解决的
  plugins: ["import"],
  parserOptions: {
    ecmaVersion: 6,
    sourceType: "module",
  },
 
};

webpack.config.js

在 chunkFilename 中加入 chunk 字段,旨在与主入口文件进行区分。

module.exports = {
  entry: "./src/main.js",
  output: {
    filename: "static/js/[name].js", // 入口文件打包输出资源命名方式
    chunkFilename: "static/js/[name].chunk.js", // 动态导入输出资源命名方式
    assetModuleFilename: "static/media/[name].[hash][ext]", // 图片、字体等资源命名方式(注意用hash)
  },
  module: {
    rules: [
      // loader的配置
      {
        oneOf: [
 // https://webpack.docschina.org/guides/asset-modules/#resource-assets
          {
            test: /\.(png|jpe?g|gif|webp|svg)$/, //$匹配结尾,在多行检测中,会匹配一行的结尾
            type: "asset", //转base64
            parser: {
              dataUrlCondition: {
                maxSize: 10 * 1024, // 小于10kb的图片转为base64,用于减少请求数据,但体积会大一点点
              },
            },
            // generator: {assetModuleFilename统一定义
            //   // 生成输出的图片名字[hash:10]表示只取前10位
            //   // ext:扩展名
            //   // query图片参数
            //   filename: "static/images/[hash:10][ext][query]",
            // },
          },
          {
            test: /\.(ttf|woff2?|mp3|mp4|avi)$/, //匹配字体图标库或者视频文件
            type: "asset/resource", //resource对文件原样的输出
            // generator: { assetModuleFilename 统一定义
            //   //输出media名称
            //   filename: "static/media/[hash:10][ext][query]",
            // },
          },
            ]
        }
    ]
},
 plugins: [
        //如果用到了css插件也要改一下
         // 提取css成单独文件
    new MiniCssExtractPlugin({
      // 定义输出文件名和目录
      filename: "static/css/[name].css",
      chunkFilename: "static/css/[name].chunk.css",
    }),
    ],
  optimization: {
    minimizer: [
// 代码分割配置
    splitChunks: {
      chunks: "all", // 对所有模块都进行分割
      // 其他内容用默认配置即可
    },
    // 提取runtime文件(防止被依赖的主文件随着变化而变化)
    runtimeChunk: {
      name: (entrypoint) => `runtime~${entrypoint.name}`, // runtime文件命名规则
    },
    ]}
}

配置命名规则后的打包结果样式如下:

webpack5 动态导入与按需加载配置

例如,当资源仅在用户点击按钮时才被加载,且该资源体积较大时,用户可能会感知到明显的页面卡顿。

若希望在浏览器空闲时段加载后续所需的资源,可采用 Preload 或 Prefetch 技术。具体参考如下:

Preload 或 Prefetch

至此,关于 webpack5 中利用 import 动态导入实现按需加载及文件统一命名的配置方法介绍完毕。如需了解更多 webpack5 import 按需加载相关内容,可搜索本站历史文章或继续浏览后续文章,感谢支持。

作者最新文章