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

# customLogger

- **类型：** [Logger](/zh/api/javascript-api/core.md#logger)
- **默认值：** `undefined`

为当前 Rsbuild 实例指定一个自定义 logger。

> 查看 [日志](/zh/guide/advanced/logging.md) 了解更多。

## 示例

使用 [createLogger](/zh/api/javascript-api/core.md#createlogger) 来创建一个新的 logger 实例。

```ts title="rsbuild.config.ts"
import { createLogger, defineConfig } from '@rsbuild/core';

const logger = createLogger({
  level: 'warn',
});

export default defineConfig({
  customLogger: logger,
});
```

## 版本历史

| 版本     | 变更内容                 |
| ------ | -------------------- |
| v2.0.0 | 新增 `customLogger` 选项 |