Node.js+TypeScript环境下Winston日志无法在控制台显示求助

可能的原因及对应解决步骤 #

1. 代码未被正确执行 #

首先确认logger模块是否被实际加载执行：

• 在logger文件顶部添加一行普通的console.log('Logger module loaded')，运行项目后查看控制台是否输出该内容。
• 如果没有输出，说明模块未被主程序引入。比如你的logger文件是src/logger.ts，需要在主入口文件（如src/index.ts）中添加import './logger'来触发执行。
• 检查package.json的scripts，添加正确的启动命令：

  "scripts": {
    "start": "ts-node src/logger.ts",
    "dev": "ts-node-dev src/logger.ts"
  }
  

  运行npm run start或npm run dev执行代码。

2. Winston控制台传输的格式配置问题 #

全局format配置可能无法被Console transport正确应用，尝试将format直接配置在Console transport中：

import { createLogger, format, transports } from 'winston';

const logger = createLogger({
  level: 'info',
  transports: [
    new transports.Console({
      format: format.combine(
        format.colorize(),
        format.timestamp(),
        format.printf(({ timestamp, level, message }) => `[${timestamp}] ${level}: ${message}`)
      )
    })
  ]
});

logger.info('Hello world!');
export default logger;

3. 模块系统兼容性问题 #

检查TypeScript配置和package.json的模块设置：

• 如果tsconfig.json中module设置为ESNext或ES2020，需要在package.json中添加"type": "module"，否则Node.js会将文件当作CommonJS模块处理，可能导致Winston导入异常：

  {
    "type": "module",
    // 其他配置...
  }
  

• 若使用CommonJS模块（tsconfig中module: "CommonJS"），保持package.json无type: module，可尝试用CommonJS风格的导入：

  const winston = require('winston');
  const logger = winston.createLogger({
    transports: [new winston.transports.Console()]
  });
  logger.info('Test log');
  

4. 日志级别配置问题 #

未显式设置level时，Winston默认级别是info，因此verbose、debug、silly级别的日志不会输出，但error、warn、info应该正常显示。若需要输出更低级别的日志，显式设置level：

const logger = winston.createLogger({
  level: 'silly', // 输出所有级别日志
  transports: [new winston.transports.Console()]
});

快速验证步骤 #

运行极简测试代码，确认基础功能正常：

import winston from 'winston';

const logger = winston.createLogger({
  level: 'info',
  transports: [new winston.transports.Console()]
});

console.log('Testing Winston...');
logger.info('Hello from Winston!');

用ts-node直接执行：npx ts-node test-winston.ts，查看是否同时输出console.log和Winston日志。

内容的提问来源于stack exchange，提问作者cealex