WinstonJS：能否为不同Transport配置自定义格式化器？

你遇到的问题核心是Winston 3.x已经彻底废弃了formatter选项——这就是你的格式化函数从未被调用的原因。不过好消息是，Winston 3.x支持为每个Transport单独配置格式化逻辑，而且新的格式化系统比旧的formatter更灵活。

为什么formatter不工作？ #

Winston 3.0进行了大规模重构，其中就包括替换了旧的格式化API，formatter这个选项在3.x版本中已经被移除，所有格式化逻辑都需要通过format选项来实现。

如何为不同Transport单独配置格式化？ #

你可以为每个Transport定义专属的格式化组合，结合Winston内置的格式化器（比如timestamp、printf）和chalk来实现控制台日志的颜色自定义。下面是完整的示例代码：

const { createLogger, transports, format } = require('winston');
const chalk = require('chalk');

// 控制台专属格式化：带颜色区分日志级别
const consoleLogFormat = format.combine(
  // 先添加时间戳（也可以放到全局format里，让所有Transport共享）
  format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }),
  format.printf(({ timestamp, level, message }) => {
    // 根据日志级别设置不同颜色
    const coloredLevel = {
      fatal: chalk.bgRed.white(level.toUpperCase()),
      error: chalk.red(level.toUpperCase()),
      warning: chalk.yellow(level.toUpperCase()),
      info: chalk.blue(level.toUpperCase()),
      debug: chalk.magenta(level.toUpperCase()),
      trace: chalk.cyan(level.toUpperCase())
    }[level] || level;

    return `${timestamp} [${coloredLevel}]: ${message}`;
  })
);

// 文件专属格式化：纯文本无颜色，保证日志文件可读性
const fileLogFormat = format.combine(
  format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }),
  format.printf(({ timestamp, level, message }) => {
    return `${timestamp} [${level.toUpperCase()}]: ${message}`;
  })
);

// 初始化Logger
this.logger = createLogger({
  levels: {
    fatal: 0,
    error: 1,
    warning: 2,
    info: 3,
    debug: 4,
    trace: 5,
  },
  transports: [
    new transports.Console({
      level: 'trace',
      format: consoleLogFormat // 控制台使用专属格式
    }),
    new transports.File({
      filename: 'combined.log',
      level: 'trace',
      format: fileLogFormat // 文件使用专属格式
    })
  ]
});

关键知识点 #

1. 格式化组合：用format.combine()可以把多个格式化步骤串联起来（比如先加时间戳，再自定义输出格式）
2. Transport专属格式：每个Transport的format选项会优先使用，你可以根据场景（控制台/文件）定义完全不同的输出样式
3. 颜色处理：chalk的颜色样式只在控制台生效，文件日志不需要颜色，所以分开定义格式可以避免日志文件中出现ANSI转义字符

如果你想让所有Transport共享某些格式化步骤（比如时间戳），也可以把这些步骤放到Logger的全局format中，示例如下：

this.logger = createLogger({
  levels: { /* ... */ },
  // 全局格式化：所有Transport都会先执行这一步
  format: format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }),
  transports: [
    new transports.Console({
      level: 'trace',
      // 只需要定义控制台专属的部分
      format: format.printf(({ timestamp, level, message }) => {
        // 颜色逻辑...
      })
    }),
    new transports.File({
      filename: 'combined.log',
      level: 'trace',
      // 文件专属的部分
      format: format.printf(({ timestamp, level, message }) => {
        // 纯文本逻辑...
      })
    })
  ]
});

内容的提问来源于stack exchange，提问作者user0103