close

HTML

Rspack 可以为应用生成 HTML 文件,并自动注入构建产物中的 JavaScript 和 CSS 资源。这在生产构建中尤其有用,因为资源文件名通常会包含内容哈希,而生成的 HTML 会始终引用最新的构建产物。

插件

Rspack 提供两种插件用于生成 HTML:

  • 内置的 HtmlRspackPlugin 针对性能和常见 HTML 生成场景做了优化;
  • 兼容社区的 HtmlWebpackPlugin,适合需要更完整的 webpack 生态兼容性,或需要 HtmlRspackPlugin 尚未实现的功能。

如果你不确定应该选择哪个插件,可以先查看 HtmlRspackPlugin 与 HtmlWebpackPlugin 的对比,了解两者在性能、功能和兼容性上的差异。

内置 HtmlRspackPlugin

HtmlRspackPlugin 是以 Rust 实现的高性能 HTML 插件,它的构建性能显著优于 HtmlWebpackPlugin 插件,尤其是在构建大量 HTML 文件的场景下。

rspack.config.mjs
import { rspack } from '@rspack/core';

export default {
  plugins: [new rspack.HtmlRspackPlugin()],
};

有关所有配置选项,请参阅插件文档

HtmlWebpackPlugin

Rspack 完全兼容 HtmlWebpackPlugin

rspack.config.mjs
import HtmlWebpackPlugin from 'html-webpack-plugin';

export default {
  plugins: [new HtmlWebpackPlugin()],
};

有关所有配置选项,请参阅插件文档