Allegro5日志系统优化：Windows平台调试输出控制

Allegro5游戏开发库的日志系统在Windows平台下存在一些需要优化的地方。本文将深入分析当前日志系统的实现细节，并提出改进方案。

当前日志系统实现分析

Allegro5的日志系统在不同平台上有不同的实现方式：

• Windows平台：默认同时使用OutputDebugString输出到调试窗口和写入日志文件
• iOS平台：输出到stderr
• Android平台：使用__android_log_print输出到系统日志
• 通用方式：当指定了trace_info.trace_file时会写入日志文件

这种实现方式在Windows平台下存在两个主要问题：

1. 默认情况下会同时输出到调试窗口和日志文件，造成重复输出
2. 调试模式下(DEBUGMODE)日志级别设置为0(DEBUG)，会输出大量冗余信息

改进方案

1. 分离Windows平台调试输出

建议为Windows平台增加一个配置选项nativelog，通过allegro5.cfg文件控制是否输出到调试窗口：

[native]
nativelog=0  ; 禁用调试窗口输出
nativelog=1  ; 启用调试窗口输出

默认值可以根据平台特性设置：

• 移动平台(iOS/Android)：默认启用(1)
• 桌面平台(Windows等)：默认禁用(0)

2. 日志级别优化

当前日志级别定义如下：

• DEBUG = 0
• INFO = 1
• WARN = 2
• ERROR = 3
• 发布模式下设置为999(不输出任何日志)

建议增加一个更细致的日志级别VERBOSE(-1)，将大量调试信息归类到这个级别。这样：

• 默认DEBUG级别(0)不会显示过于详细的日志
• 需要详细日志时可以显式设置为VERBOSE级别

3. 日志分类整理

对现有日志进行重新分类：

• 关键路径日志保持为DEBUG级别
• 高频次、低信息量的日志降级为VERBOSE级别
• 重要信息保持为INFO级别
• 警告和错误保持不变

实现建议

在src/debug.c中实现以下修改：

1. 增加日志级别常量：

#define ALLEGRO_VERBOSE -1
#define ALLEGRO_DEBUG   0
#define ALLEGRO_INFO    1
#define ALLEGRO_WARN    2
#define ALLEGRO_ERROR   3

2. 修改Windows平台输出逻辑，增加对nativelog配置的检查

3. 调整默认日志级别：

#ifdef DEBUGMODE
#define DEFAULT_LOG_LEVEL ALLEGRO_DEBUG
#else
#define DEFAULT_LOG_LEVEL 999
#endif

这些改进将使Allegro5的日志系统更加灵活和实用，特别是在Windows平台的开发调试过程中，开发者可以更好地控制日志输出，提高调试效率。