Debian下如何配置JS日志输出

在Debian环境下搭建Node.js应用时，日志配置往往是被忽视但又至关重要的一环。如果你只是用`console.log`随手打几条信息，等上了生产环境，排查问题会非常痛苦。下面从最基础的方案讲到工业级实践，希望能帮你一步到位。 --- ### 一、直接用 `console` 对象：快速上手，仅限开发 Node.js 内置的 `console` 对象是日志输出的零成本方案，适合调试阶段临时使用。比如： ```ja vascript console.log('This is a log message'); console.error('This is an error message'); ``` 优点是无任何依赖，但缺点也很明显——没有日志级别区分，没有格式化，无法持久化到文件。生产环境用它，等于把隐患敞着门。 --- ### 二、第三方日志库：专业级的起点 当项目需要日志级别、格式化、文件输出等功能，就该引入成熟的日志库了。社区中 `winston` 和 `pino` 是最常用的两个选择。 #### 2.1 使用 `winston` `winston` 功能全面，适合对配置灵活性要求较高的场景。安装方式： ```bash npm install winston ``` 一个基础配置示例： ```ja vascript const winston = require('winston'); const logger = winston.createLogger({ level: 'info', format: winston.format.json(), transports: [ new winston.transports.File({ filename: 'error.log', level: 'error' }), new winston.transports.File({ filename: 'combined.log' }) ] }); logger.info('This is an info message'); logger.error('This is an error message'); ``` 这里将错误日志单独写入 `error.log`，所有日志（info及以上级别）写入 `combined.log`，而且都采用JSON格式输出，方便后续用ELK等工具采集。 #### 2.2 使用 `pino` `pino` 主打性能，是目前Node.js社区最快的日志库之一，适合高吞吐量场景。安装： ```bash npm install pino ``` 配置极简： ```ja vascript const pino = require('pino'); const logger = pino({ level: 'info' }); logger.info('This is an info message'); logger.error('This is an error message'); ``` `pino` 默认输出为JSON行，并且几乎没有性能开销。如果你的应用每秒要处理上万请求，`pino` 是很明智的选择。 --- ### 三、日志轮转：生产环境的必备技能 日志文件如果无限制增长，迟早会撑爆磁盘。解决方案是按时间或大小自动轮转、压缩归档。`winston-daily-rotate-file` 是 `winston` 生态中最常用的轮转插件。 安装： ```bash npm install winston-daily-rotate-file ``` 配置示例： ```ja vascript const winston = require('winston'); const { createLogger, format, transports } = winston; const DailyRotateFile = require('winston-daily-rotate-file'); const transport = new DailyRotateFile({ filename: 'application-%DATE%.log', datePattern: 'YYYY-MM-DD-HH', zippedArchive: true, maxSize: '20m', maxFiles: '14d' }); const logger = createLogger({ level: 'info', format: format.combine( format.timestamp(), format.json() ), transports: [ transport, new transports.Console({ format: format.simple() }) ] }); logger.info('This is an info message'); logger.error('This is an error message'); ``` 这个配置做到了：按小时生成日志文件（`application-2026-06-29-10.log`），单个文件超过20MB自动换新，最多保留14天的日志，并且历史文件自动压缩成`.gz`。同时控制台保持简单文本输出，方便实时查看。 --- 综上，从开发阶段的 `console.log` 到生产级的 `winston`/`pino` 配合日志轮转，每一步都有明确的场景和权衡。在Debian系统下配置其实没有任何特殊之处——只需保证Node.js环境正常、npm包安装顺利，剩下的就是根据业务需要选择合适的方案。如果你正在搭建新项目，不妨直接从 `pino` + 轮转日志开始，既快又稳。