如何自定义 Debian Node.js 日志输出

在 Debian 系统上折腾 Node.js 应用，日志输出这件事，看起来简单，但真要调得顺手、方便排查问题，还是有不少门道的。如果只是用 console.log 随便打几条信息，开发阶段倒还好，一旦上了生产环境或者需要多人协作，日志格式、级别、输出目标这些就都得认真规划一下。下面聊几种常见且实用的方法，你可以根据项目的具体需求来选。

方法一：用 console.log 配合自定义格式化

最基础的方式，就是直接用 console.log 输出，再通过模板字符串或者一些轻量级的格式化库（比如 logform 或 winston 的格式化工具）来控制输出样式。这种方式适合简单的场景，不需要引入额外的日志框架。

const log = require('logform').combine(
  log.formatters.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }),
  log.formatters.json()
);
console.log(log.info('This is an info message'));
console.log(log.error('This is an error message'));

方法二：使用 winston 日志库

如果你需要更强大的功能——比如同时把日志写入文件、控制台，还要支持不同级别、不同格式——那 winston 几乎是不二之选。它在 Node.js 生态里非常成熟，配置灵活，可以满足从开发到生产的大部分需求。

1. 安装 winston：

npm install winston

2. 创建或配置日志器：

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.json()
  ),
  transports: [
    new winston.transports.File({ filename: 'error.log', level: 'error' }),
    new winston.transports.File({ filename: 'combined.log' })
  ]
});
if (process.env.NODE_ENV !== 'production') {
  logger.add(new winston.transports.Console({
    format: winston.format.simple()
  }));
}
logger.info('This is an info message');
logger.error('This is an error message');

方法三：用 morgan 记录 HTTP 请求日志（Express 应用）

如果你的应用基于 Express 框架，那么每次客户端的 HTTP 请求日志，用 morgan 中间件来搞定最方便。它自带很多预定义格式，也支持自定义 token，可以准确记录请求方法、URL、状态码、响应时间等信息。

1. 安装 morgan：

npm install morgan

2. 在 Express 中配置：

const express = require('express');
const morgan = require('morgan');
const app = express();
// 自定义 morgan 格式
morgan.token('customFormat', (req, res) => {
  return `${req.method} ${req.url} - ${res.statusCode}`;
});
app.use(morgan('customFormat'));
app.get('/', (req, res) => {
  res.send('Hello World!');
});
app.listen(3000, () => {
  console.log('Server is running on port 3000');
});

方法四：使用 pino 日志库

如果你的应用对性能要求极高，比如每秒要处理成千上万个请求，那 pino 值得考虑。它主打低开销、高吞吐，输出的是 JSON 格式，方便后续日志收集和分析。配合 pino-pretty 还可以在开发环境下让日志更可读。

1. 安装 pino：

npm install pino

2. 使用方式：

const pino = require('pino');
const logger = pino({
  level: 'info',
  transport: {
    target: 'pino-pretty',
    options: { colorize: true }
  }
});
logger.info('This is an info message');
logger.error('This is an error message');

说到底，选择哪种方案，主要看你的应用规模、对性能的要求，以及团队习惯。小项目用 console.log 加个时间戳就够了；中大型项目推荐 winston 或 pino；如果是 Express 应用，morgan 处理请求日志是标配。根据实际场景灵活搭配就好。