Skip to content

Webpack 5 Beta 新特性预览

Webpack 5 已经进入 Beta 阶段,虽然还没正式发布,但新特性值得关注。梳理一下对我们日常开发影响最大的几个变化。

Module Federation:微前端的官方解法

这是 Webpack 5 最重磅的特性,允许多个独立构建的应用共享模块:

javascript
// app1/webpack.config.js
const { ModuleFederationPlugin } = require('webpack').container;

module.exports = {
  plugins: [
    new ModuleFederationPlugin({
      name: 'app1',
      filename: 'remoteEntry.js',
      exposes: {
        // 暴露组件给其他应用使用
        './Button': './src/components/Button',
        './utils': './src/utils/helpers',
      },
      shared: {
        vue: { singleton: true },
        'vue-router': { singleton: true },
      },
    }),
  ],
};

// app2/webpack.config.js
module.exports = {
  plugins: [
    new ModuleFederationPlugin({
      name: 'app2',
      remotes: {
        app1: 'app1@http://localhost:3001/remoteEntry.js',
      },
      shared: {
        vue: { singleton: true },
        'vue-router': { singleton: true },
      },
    }),
  ],
};

// app2 中使用 app1 的组件
const Button = () => import('app1/Button');

这意味着微前端不再需要 iframe 或 single-spa 那么重的方案了。

持久化缓存

Webpack 5 内置了持久化缓存,不再需要 hard-source-webpack-plugin

javascript
// webpack.config.js
module.exports = {
  cache: {
    type: 'filesystem',
    buildDependencies: {
      config: [__filename], // 配置文件变更时失效
    },
    cacheDirectory: path.resolve(__dirname, '.webpack_cache'),
  },
};

实测:二次构建时间从 45 秒降到 8 秒。

资源模块 (Asset Modules)

内置了资源处理,不再需要 file-loaderurl-loaderraw-loader

javascript
// Webpack 4
module.exports = {
  module: {
    rules: [
      {
        test: /\.(png|jpg|gif)$/,
        use: [
          {
            loader: 'url-loader',
            options: { limit: 8192 },
          },
        ],
      },
    ],
  },
};

// Webpack 5
module.exports = {
  module: {
    rules: [
      {
        test: /\.(png|jpg|gif)$/,
        type: 'asset', // 自动选择 inline 或 external
        parser: {
          dataUrlCondition: {
            maxSize: 8 * 1024,
          },
        },
      },
      {
        test: /\.txt$/,
        type: 'asset/source', // 相当于 raw-loader
      },
      {
        test: /\.svg$/,
        type: 'asset/resource', // 相当于 file-loader
      },
    ],
  },
};

Tree Shaking 增强

javascript
// package.json 中声明 sideEffects
{
  "sideEffects": [
    "*.css",
    "*.scss"
  ]
}

// Webpack 5 新增:
// 1. 嵌套 tree shaking:连嵌套模块的导出也能分析
// 2. 内部模块 tree shaking:模块内部的导出也能被 shake
// 3. CommonJS tree shaking:对 CommonJS 也生效(部分场景)

// 新增 optimization.usedExports 和 innerGraph
module.exports = {
  optimization: {
    usedExports: true,
    innerGraph: true, // 新:分析模块内部的依赖图
  },
};

最小 Node.js 版本

Webpack 5 要求 Node.js >= 10.13.0。在升级前确认 CI 环境。

迁移注意事项

bash
# 升级命令
npm install webpack@next webpack-cli@latest -D

# 需要同步升级的插件
npm install -D webpack-dev-server@latest html-webpack-plugin@next

# 可能需要移除的(已内置)
npm uninstall file-loader url-loader raw-loader hard-source-webpack-plugin
javascript
// 常见报错及修复
// 1. Buffer 不再 polyfill
// 需要手动安装 buffer
resolve: {
  fallback: {
    buffer: require.resolve('buffer/'),
  },
}

// 2. process 不再 polyfill
// 安装 process/browser
resolve: {
  fallback: {
    process: require.resolve('process/browser'),
  },
}

小结

  • Module Federation 是微前端的重大突破,值得深入研究
  • 持久化缓存大幅缩短二次构建时间
  • Asset Modules 简化了资源处理配置
  • Tree Shaking 更智能,产出更小
  • Node.js 最低版本要求提升到 10.13.0,升级前检查环境

MIT Licensed