> For AI agents: the complete documentation index is available at /zh/llms.txt, the full documentation bundle is available at /zh/llms-full.txt.

# tools.cssLoader

- **类型：** `Object | Function`
- **默认值：** 基于 [output.cssModules](/zh/config/output/css-modules.md) 和 [output.sourceMap](/zh/config/output/source-map.md) 生成。

Rsbuild 默认使用 [css-loader](https://github.com/webpack/css-loader) 来处理 CSS 资源。你可以通过 `tools.cssLoader` 来修改 css-loader 的选项。

:::tip
如果你需要修改 CSS Modules 相关的选项，推荐优先使用 [output.cssModules](/zh/config/output/css-modules.md) 配置项。
:::

### Object 类型

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

```ts title="rsbuild.config.ts"
export default {
  tools: {
    cssLoader: {
      modules: {
        exportOnlyLocals: true,
      },
    },
  },
};
```

### Function 类型

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

```ts title="rsbuild.config.ts"
export default {
  tools: {
    cssLoader: (config) => {
      config.modules.exportOnlyLocals = true;
      return config;
    },
  },
};
```