For AI agents: the complete documentation index is available at /zh/llms.txt, the full documentation bundle is available at /zh/llms-full.txt, and this page is available as Markdown at /zh/configure/app/output/disable-inline-runtime-chunk.md.
  • 简体中文
  • output.disableInlineRuntimeChunk

    • 类型: boolean
    • 默认值: false

    用于控制是否将打包工具的 runtime 代码内联到 HTML 中。

    什么是 runtimeChunk

    当构建完成后,会在 dist 目录生成 builder-runtime.js 文件,该文件为 Rspack 的 runtime 代码,即 runtimeChunk。

    runtimeChunk 是一段运行时代码,它由 Rspack 提供,包含必要的模块处理逻辑,比如模块加载、模块解析等,具体可参考 Runtime Chunk。

    在生产环境下,Modern.js 默认会将 runtimeChunk 文件内联到 HTML 文件中,而不是写到产物目录中,这样做是为了减少文件请求的数量。

    禁用内联

    如果你不希望 runtimeChunk 文件被内联到 HTML 文件里,可以把 disableInlineRuntimeChunk 设置为 true,此时会生成一个独立的 builder-runtime.js 文件。

    export default {
      output: {
        disableInlineRuntimeChunk: true,
      },
    };

    合并到页面文件中

    如果你不希望生成独立的 runtimeChunk 文件,而是想让 runtimeChunk 代码被打包到页面的 JS 文件里,可以这样设置:

    export default {
      tools: {
        bundlerChain(chain) {
          chain.optimization.runtimeChunk(false);
        },
      },
    };