Consola日志库中如何为所有级别启用徽章显示

Consola是一个功能强大的Node.js日志记录库，它提供了多种日志级别和美观的输出格式。其中FancyReporter是默认的日志报告器，它以彩色和格式化的方式输出日志信息。

问题背景

在Consola的FancyReporter中，默认情况下只有部分日志级别会显示徽章(badge)。例如，info、success、warn和error级别会显示徽章，而其他级别如log、debug等则不会显示。这种设计可能是为了保持控制台输出的简洁性，但有时开发者希望为所有日志级别都启用徽章显示。

解决方案

Consola实际上已经提供了为所有级别启用徽章的配置选项。可以通过在创建Consola实例时设置defaults.badge为true来实现：

import { createConsola } from 'consola'

const consola = createConsola({
  defaults: {
    badge: true,  // 强制所有级别显示徽章
  },
})

consola.info('信息级别日志')  // 会显示徽章
consola.log('普通日志')      // 现在也会显示徽章

类型定义问题

需要注意的是，当前版本的Consola类型定义中尚未包含badge选项，因此在TypeScript项目中可能会收到类型错误提示。但这只是一个类型检查问题，不影响实际运行效果。

开发者可以通过以下方式绕过类型检查：

const consola = createConsola({
  defaults: {
    badge: true as any,  // 临时解决方案
  },
})

或者更优雅的方式是扩展类型定义：

declare module 'consola' {
  interface InputLogObject {
    badge?: boolean
  }
}

实现原理

在Consola的FancyReporter内部，徽章显示逻辑是通过检查日志对象的badge属性来决定的。当设置为true时，会强制显示徽章；当未设置时，则只对特定级别显示徽章。

这种设计提供了灵活性，开发者可以根据需要为特定日志消息单独控制徽章显示：

consola.log({
  message: '特定日志消息',
  badge: true  // 只为这条消息显示徽章
})

最佳实践

1. 如果项目需要所有日志级别都显示徽章，建议在创建Consola实例时全局设置
2. 对于临时需要显示徽章的特定日志，可以在日志对象中单独设置
3. 在TypeScript项目中，可以等待官方更新类型定义或自行扩展类型

Consola的这种设计体现了良好的灵活性，既保持了默认的简洁性，又为特殊需求提供了配置选项。