Consola日志库在Windows环境下的静默问题排查

问题现象

在使用Consola日志库时，开发者可能会遇到一个奇怪的现象：在Windows系统的PowerShell或CMD终端中运行程序时，Consola完全不输出任何日志信息，而在WSL(Linux子系统)环境下却能正常输出。这个问题尤其在使用Nuxt.js框架时容易被发现，因为Nuxt内部也使用了Consola作为日志工具。

问题重现

通过一个最简单的测试用例就能重现这个问题：

const { consola } = require("consola");
consola.info("Test");

在Windows终端执行这段代码时，控制台没有任何输出，而同样的代码在WSL环境下却能正常显示日志信息。

根本原因分析

经过深入排查，发现这个问题与环境变量中的TEST变量有关。当系统中存在名为TEST的环境变量时，Consola会默认进入"测试运行器环境"模式。在这种模式下，Consola会将日志级别限制为"warn"及以上级别，导致普通的info日志不会显示。

Consola源码中对此有明确的逻辑判断：当检测到TEST环境变量存在时，会自动调整日志级别。这是一种常见的设计模式，目的是在测试环境中减少不必要的日志输出，使测试结果更加清晰。

解决方案

解决这个问题有以下几种方法：

1. 删除TEST环境变量：这是最直接的解决方案。在Windows系统中：

   • 打开系统属性 -> 高级 -> 环境变量
   • 在用户变量或系统变量中查找名为TEST的变量
   • 删除该变量或将其重命名为其他名称

2. 显式设置日志级别：在代码中强制指定Consola的日志级别，覆盖环境变量的影响：

   const { consola } = require("consola");
   consola.level = 3; // 设置为info级别
   consola.info("Test");
   

3. 创建自定义Consola实例：创建一个不受环境变量影响的新实例：

   const { createConsola } = require("consola");
   const logger = createConsola({ level: 3 });
   logger.info("Test");
   

预防措施

为了避免类似问题再次发生，建议：

1. 避免使用常见的测试相关名称作为环境变量名，如TEST、CI、DEBUG等
2. 在关键应用中显式设置日志级别，而不是依赖默认行为
3. 在文档中记录应用依赖的环境变量，避免命名冲突

总结

Consola作为一款流行的日志库，其设计考虑了多种使用场景，包括测试环境。了解其与环境变量的交互方式对于正确使用该库非常重要。当遇到日志不输出的问题时，检查环境变量设置应该是排查步骤之一。这个问题也提醒我们，在设置环境变量时应该注意命名规范，避免与常用工具的关键字冲突。