Node.js日志输出内容定制指南

在实际开发中，日志输出往往是调试和运维的第一道防线。那么，如何让Node.js的日志输出更符合你的需求？下面几种方法，从简单到专业，总有一款适合你。

使用Node.js内置console方法

最简单直接的方式——用Node.js内置的console方法。比如console.log()、console.error()、console.warn()和console.info()，它们能输出字符串、数字、对象等各种类型的数据。适合快速验证或小型项目。

console.log('Hello, World!');
console.error('An error occurred');
console.warn('This is a warning');
console.info('This is an info message');

使用第三方日志库winston

当项目复杂度上升，内置方法就显得力不从心了。这时可以考虑第三方日志库，比如winston或bunyan。它们提供了日志级别、格式化、多目标输出等功能，让日志管理变得井井有条。

以winston为例，先安装：

npm install winston

然后在代码中创建logger实例，配置格式和目标：

const winston = require('winston');

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

logger.info('This is an info message');
logger.error('This is an error message');

使用log4js实现更灵活的控制

如果需求再往上走，比如需要更灵活的配置、插件扩展或更细粒度的控制，log4js是个不错的选择。它的功能与winston类似，但配置选项和插件生态更丰富。

先安装：

npm install log4js

然后配置并创建logger：

const log4js = require('log4js');

log4js.configure({
  appenders: {
    out: { type: 'stdout', layout: { type: 'pattern', pattern: '[%d] [%p]: %m%n' } },
    fileError: { type: 'file', filename: 'logs/error.log', layout: { type: 'pattern', pattern: '[%d] [%p]: %m%n' } },
    fileCombined: { type: 'file', filename: 'logs/combined.log', layout: { type: 'pattern', pattern: '[%d] [%p]: %m%n' } },
  },
  categories: {
    default: { appenders: ['out'], level: 'info' },
    error: { appenders: ['fileError'], level: 'error' },
    combined: { appenders: ['out', 'fileCombined'], level: 'info' },
  },
});

const logger = log4js.getLogger('default');
logger.info('This is an info message');
logger.error('This is an error message');

通过上述几种方法，你可以根据项目阶段和规模灵活选择，定制出真正适合自己应用的日志输出方案。