close
  • 简体中文
  • output.injectStyles

    • 类型: boolean
    • 默认值: false

    是否将 CSS 样式插入到 DOM 中。

    默认情况下,Rsbuild 会把 CSS 提取为独立的 .css 文件,并输出到构建产物目录。设置该选项为 true 后,CSS 文件会被内联到 JS 文件中,并在运行时通过 <style> 标签插入到页面上。该功能基于 style-loader 实现。

    示例

    rsbuild.config.ts
    export default {
      output: {
        injectStyles: true,
      },
    };

    配置 style-loader

    在开启 output.injectStyles 时,你可以通过 tools.styleLoader 来修改 style-loader 的选项。

    使用场景

    建议仅在开发模式开启 injectStyles 选项。

    对于生产模式构建,建议使用 Rsbuild 的默认行为,将 CSS 抽取为单独的 bundle,以便浏览器能够并行加载 CSS 和 JS 资源。

    比如:

    rsbuild.config.ts
    export default {
      output: {
        injectStyles: process.env.NODE_ENV === 'development',
      },
    };