TypeScript 日志记录：Winston 库

什么是Winston，为什么需要它？

Winston 是一个用于 TypeScript 和 JavaScript 应用程序的强大且灵活的日志记录库。它允许将日志记录到不同的位置（控制台、文件、数据库），并具有不同的重要性级别。与简单的 console.log 不同，Winston 提供了对日志格式、轮转和过滤的完全控制。

为什么需要使用 Winston？在大型项目中，标准控制台输出变得毫无用处：日志混杂、丢失，无法进行分析。Winston 解决了这些问题：您可以配置将错误记录到单独的文件中，将信息消息输出到控制台，并将调试数据记录到数据库中。这对于调试、监控和审计至关重要。

安装

要在 TypeScript 项目中安装 Winston，请执行以下命令：

npm install winston

还建议安装类型定义：

npm install --save-dev @types/winston

如果您使用 yarn：

yarn add winston

主要功能

日志级别：error、warn、info、http、verbose、debug、silly。每个级别都有优先级，您可以配置在不同传输（transport）中输出哪些级别。
传输（Transports）：日志输出的方式。内置传输包括：Console、File、Http、Stream。您也可以创建自定义传输。
格式（Formats）：配置日志的外观（JSON、时间戳、彩色输出）。
文件轮转：通过额外的模块 winston-daily-rotate-file，可以根据日期或文件大小自动创建新的日志文件。
元数据：传递额外的上下文信息（例如，请求 ID、用户名）。

TypeScript 代码示例

创建一个简单的日志记录器，输出到控制台和文件：

import winston from 'winston';

const logger = winston.createLogger({  level: 'info',  format: winston.format.combine(    winston.format.timestamp(),    winston.format.json()  ),  transports: [    new winston.transports.Console({      format: winston.format.combine(        winston.format.colorize(),        winston.format.simple()      )    }),    new winston.transports.File({ filename: 'error.log', level: 'error' }),    new winston.transports.File({ filename: 'combined.log' })  ]});

// 使用logger.info('服务器已在端口3000上启动');logger.error('数据库连接错误', { database: 'main' });

在此示例中：信息消息输出到控制台（带颜色）和文件 combined.log，而错误则额外输出到 error.log。日志格式为 JSON 并带有时间戳。