如何在控制台应用中实现可通过命令行参数开关的日志功能？

这问题我太有共鸣了——手动插删console.log真的是重复又低效！下面给你几个从简单到进阶的方案，完美解决用命令行参数/环境变量控制日志开关的需求：

方案一：手动解析命令行参数（零依赖，小型项目首选） #

直接利用Node.js自带的process.argv获取启动参数，封装一个带开关的日志函数：

// 解析启动命令里的debug参数
const isDebug = process.argv.some(arg => arg === 'debug=true');

// 封装调试日志函数
const debugLog = (...args) => {
  if (isDebug) {
    // 加个[DEBUG]前缀方便区分普通日志
    console.log('[DEBUG]', ...args);
  }
};

// 业务代码里直接用就行
debugLog('当前用户ID：', req.user.id);
debugLog('接口响应耗时：', Date.now() - startTime, 'ms');

启动时只要加参数就行：node app.js debug=true，不想看日志时去掉参数或者改成debug=false。

方案二：用环境变量（更规范，跨平台友好） #

命令行参数有时候不够灵活，用环境变量是Node.js项目的常规操作，还能配合.env文件批量管理配置：

基础用法（零依赖） #

启动命令分平台：

• Linux/macOS：DEBUG=true node app.js
• Windows：set DEBUG=true && node app.js

代码里通过process.env读取：

const isDebug = process.env.DEBUG === 'true';

const debugLog = (...args) => {
  if (isDebug) {
    console.log('[DEBUG]', ...args);
  }
};

进阶：用dotenv管理环境变量 #

如果不想每次启动都敲环境变量，装个dotenv包：

npm install dotenv

在项目根目录创建.env文件：

DEBUG=true

然后在代码开头加载：

require('dotenv').config();

const isDebug = process.env.DEBUG === 'true';
const debugLog = (...args) => {
  if (isDebug) {
    console.log('[DEBUG]', ...args);
  }
};

这样开发环境自动加载调试模式，生产环境只要把.env里的DEBUG改成false或者删掉就行。

方案三：用成熟日志库（中大型项目首选） #

如果项目复杂度高，需要区分日志级别（info/warn/error/debug）、输出到文件/数据库等，直接用专业日志库，比如winston或者pino：

以winston为例，先安装：

npm install winston

配置日志器：

const winston = require('winston');

const logger = winston.createLogger({
  // 根据环境变量设置日志级别：debug模式下输出所有级别，否则只输出info及以上
  level: process.env.DEBUG ? 'debug' : '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: 'error.log', level: 'error' }),
    new winston.transports.File({ filename: 'combined.log' })
  ]
});

// 使用示例
logger.debug('调试信息：Redis连接成功');
logger.info('常规信息：用户完成下单');
logger.warn('警告信息：磁盘空间不足');
logger.error('错误信息：数据库查询失败');

启动时同样用DEBUG=true node app.js控制，这种方案扩展性极强，完全能满足大型项目的日志需求。

额外小技巧：给调试日志加颜色 #

装个chalk包让调试日志更显眼：

npm install chalk

修改日志函数：

const chalk = require('chalk');

const debugLog = (...args) => {
  if (isDebug) {
    console.log(chalk.blueBright('[DEBUG]'), ...args);
  }
};

这样调试日志会变成蓝色，和普通日志一眼就能区分开～

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