指南
配置
插件
API
社区
指南
配置
插件
API
社区
简体中文

tools.cssLoader

  • 类型： Object | Function
  • 默认值：
const defaultOptions = {
  modules: rsbuildConfig.output.cssModules,
  sourceMap: rsbuildConfig.output.sourceMap.css,
  // 在编译 css 文件时为 `1`，在编译 sass/less 文件时为 `2`
  importLoaders: 1 || 2,
};

Rsbuild 默认使用 css-loader 来处理 CSS 资源。你可以通过 tools.cssLoader 来修改 css-loader 的选项。

TIP

如果你需要修改 CSS Modules 相关的选项，推荐优先使用 output.cssModules 配置项。

Object 类型

当此值为 Object 类型时，会与默认配置进行深层合并 (deep merge)。比如：

export default {
  tools: {
    cssLoader: {
      modules: {
        exportOnlyLocals: true,
      },
    },
  },
};

Function 类型

当此值为 Function 类型时，默认配置作为第一个参数传入，你可以直接修改配置对象，也可以返回一个对象作为最终配置。比如：

export default {
  tools: {
    cssLoader: (config) => {
      config.modules.exportOnlyLocals = true;
      return config;
    },
  },
};