Node.js日志格式化有哪些推荐方式

在Node.js里，日志格式化这件事儿，看起来简单，但真要折腾起来，门道还挺多。不同场景、不同需求，选择的方式也大相径庭。下面就把几种常见且好用的方案拎出来聊聊，从最朴素的到功能最完备的，一个个看过去。

1. 用 console.log 自己拼格式

别看console.log原生得不能再原生，但胜在零依赖、零学习成本。你完全可以手拼一个简单的模板：

const timestamp = new Date().toISOString();
const logMessage = `[${timestamp}] [INFO] ${message}`;
console.log(logMessage);

这种方式的优点是灵活，想怎么拼就怎么拼；缺点是重复代码多，日志级别管理、文件输出这些都得自己造轮子。适合快速验证或玩具项目。

2. 用 winston 搞定一切

说到Node.js日志库，winston 绝对是个绕不开的名字。它提供了几乎你能想到的所有传输方式（控制台、文件、网络……）和格式化能力。关键在于它的format组件可以自由组合——时间戳、级别、自定义输出模板，一条链搞定。

const winston = require('winston');

const logger = winston.createLogger({
  level: 'info',
  format: winston.format.combine(
    winston.format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }),
    winston.format.printf(({ timestamp, level, message }) => {
      return `[${timestamp}] [${level.toUpperCase()}] ${message}`;
    })
  ),
  transports: [
    new winston.transports.Console(),
    new winston.transports.File({ filename: 'error.log', level: 'error' }),
    new winston.transports.File({ filename: 'combined.log' })
  ]
});

logger.info('Hello, world!');

代码里清晰定义了日志级别、时间格式、输出样式，还能同时往不同文件写不同级别的日志。生产环境里，winston 几乎是标配。

3. 用 pino 追求极致性能

如果对日志写入速度有严格要求，pino 值得认真考虑。它号称是当前最快的Node.js日志库，采用结构化日志，而且配合pino-pretty可以在开发时把JSON格式美化乘人眼能直接看的样式。

const pino = require('pino');
const prettyPrint = require('pino-pretty');

const logger = pino({
  level: 'info',
  transport: {
    target: 'pino-pretty',
    options: {
      colorize: true,
      translateTime: 'SYS:standard'
    }
  }
});

logger.info('Hello, world!');

注意它的配置方式——transport 直接指定输出美化器，性能开销极低。适合对QPS敏感的后端服务。

4. 用 morgan 专门处理HTTP请求日志

Express 项目里，日志需求往往集中在对每个请求的访问记录上。这时候morgan 就是最趁手的工具。它内置了combined、common、dev等多种预设格式，直接挂载成中间件即可。

const express = require('express');
const morgan = require('morgan');
const app = express();

app.use(morgan('combined'));

app.get('/', (req, res) => {
  res.send('Hello, world!');
});

app.listen(3000, () => {
  console.log('Server is running on port 3000');
});

想自定义输出格式也只需要传一个字符串模板，比如:method :url :status :response-time ms。简单直接，适合快速建立请求审计能力。

5. 用 log4js 延续Ja va传统

如果团队里有Ja va背景的成员，log4js 会让他们感到无比亲切。它的配置风格借鉴了Log4j，通过appenders和categories来管理输出目标及格式。

const log4js = require('log4js');

log4js.configure({
  appenders: {
    out: { type: 'stdout', layout: { type: 'pattern', pattern: '[%d{yyyy-mm-dd HH:mm:ss}] [%p] %m%n' } }
  },
  categories: {
    default: { appenders: ['out'], level: 'info' }
  }
});

const logger = log4js.getLogger();
logger.info('Hello, world!');

它的布局模式（pattern）功能强大，支持毫秒、类别、文件名等占位符，而且可以同时配置多个appenders写入不同介质。对需要细粒度日志路由的场景来说，非常顺手。

该怎么选

没有最好的方案，只有最合适的。如果只是写个脚本，console.log 够用；一个正经的Web应用，winston 或者 pino 均可；需要记录HTTP访问，morgan 无缝集成；有Ja va日志迁移需求，log4js 值得一试。关键是别被眼花缭乱的选择带偏，抓住自己的场景痛点再出手。