#customLogger

• 类型： Logger
• 默认值： undefined

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

#示例

使用 createLogger 来创建一个新的 logger 实例。

import { createLogger, defineConfig } from '@rsbuild/core';

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

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

#全局 logger 与实例 logger

Rsbuild 提供了两种获取 logger 的方式：

• 全局 logger 是从 @rsbuild/core 导出的共享 logger 单例。
• 实例 logger 是当前 Rsbuild 实例关联的 logger，可以通过 rsbuild.logger 获取，在插件中也可以通过 api.logger 获取。

当未配置 customLogger 时，实例 logger 会回退到共享的全局 logger；当配置了 customLogger 时，实例 logger 则会引用该自定义 logger。

#版本历史