琦玉老师比我秃1. UE日志系统基础概念
虚幻引擎（Unreal Engine）的日志系统是开发过程中不可或缺的调试工具，它像一位全天候的工程记录员，默默记录着引擎运行时的各种状态信息。这套系统基于自定义的日志分类和分级机制，能够帮助开发者快速定位问题所在。
日志系统在UE中的核心实现位于CoreGlobals.h和LoggingMacros.h文件中。每个日志消息都包含三个关键属性：日志类别（Log Category）、日志级别（Verbosity Level）和时间戳。其中日志类别用于区分不同模块的消息，而日志级别则决定了消息的重要性。
在引擎源代码中，你会看到这样的典型日志声明：
cpp复制DEFINE_LOG_CATEGORY(LogMyGame);
这个宏定义创建了一个名为LogMyGame的新日志类别，之后就可以在代码中使用该类别输出日志：
cpp复制UE_LOG(LogMyGame, Warning, TEXT("Player %s has invalid health value!"), *PlayerName);
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. UE日志等级详解
虚幻引擎定义了6种标准日志等级，每种等级都有特定的使用场景和显示规则：
2.1 致命错误（Fatal）
这是最高级别的日志，表示发生了无法恢复的严重错误。当记录Fatal级别的日志时，引擎会立即终止运行并显示错误信息。典型使用场景包括：
- 内存分配失败
- 关键资源加载失败
- 断言检查失败
示例代码：
cpp复制UE_LOG(LogMyGame, Fatal, TEXT("Failed to allocate memory for texture!"));
提示：Fatal级别的日志应该谨慎使用，只在确实无法继续运行的情况下调用。滥用会导致用户体验不佳。
2.2 错误（Error）
Error级别表示发生了严重问题，但引擎可能还能继续运行。这类日志通常用于：
- 资源加载失败但有备用方案
- 网络连接中断
- 无效的用户输入
示例：
cpp复制UE_LOG(LogMyGame, Error, TEXT("Failed to load level '%s'"), *LevelName);
2.3 警告（Warning）
Warning级别表示潜在问题或非预期情况，但不会立即影响功能。常见用例包括：
- 使用默认值替代缺失配置
- 弃用功能的提醒
- 性能警告
示例：
cpp复制UE_LOG(LogMyGame, Warning, TEXT("Using default material for missing asset %s"), *MaterialName);
2.4 显示（Display）
Display是默认的普通信息级别，用于记录重要的运行时信息：
- 游戏状态变化
- 关键事件发生
- 系统初始化完成
示例：
cpp复制UE_LOG(LogMyGame, Display, TEXT("Game instance initialized successfully"));
2.5 日志（Log）
Log级别用于详细的调试信息，在开发过程中很有用但通常不需要在发布版本中显示：
- 详细的算法执行过程
- 循环迭代信息
- 非关键的系统状态
示例：
cpp复制UE_LOG(LogMyGame, Log, TEXT("Processing chunk %d/%d"), CurrentChunk, TotalChunks);
2.6 详细（Verbose）
Verbose是最低级别的日志，提供极其详细的信息，通常只在深度调试时启用：
- 每帧的详细数据
- 高频事件的记录
- 内部状态跟踪
示例：
cpp复制UE_LOG(LogMyGame, Verbose, TEXT("Actor %s position updated to %s"), *ActorName, *Position.ToString());
3. 日志等级的实际应用
3.1 配置日志输出级别
在DefaultEngine.ini中，可以配置每个日志类别的输出级别：
ini复制[Core.Log]
LogMyGame=Warning
LogTemp=Log
这表示LogMyGame类别只显示Warning及以上级别的消息，而LogTemp显示Log及以上级别的消息。
3.2 运行时控制日志级别
在编辑器或打包版本中，可以使用控制台命令动态调整日志级别：
code复制Log LogMyGame Warning // 设置LogMyGame类别为Warning级别
Log Reset // 重置所有日志类别为默认级别
3.3 性能考量
日志输出虽然方便，但也会带来性能开销，特别是在Verbose级别。以下是一些优化建议：
- 避免在热路径（高频调用的代码）中使用Verbose日志
- 使用
UE_LOG宏的条件编译特性：
cpp复制#if !UE_BUILD_SHIPPING
UE_LOG(LogMyGame, Verbose, TEXT("Debug info: %f"), DebugValue);
#endif
- 对于复杂的日志消息，先检查日志级别是否启用：
cpp复制if(LogMyGame.IsSuppressed(Verbose) == false)
{
// 准备复杂的日志参数
UE_LOG(LogMyGame, Verbose, TEXT("Complex message: %s"), *ComplexString);
}
4. 高级日志技巧
4.1 自定义日志类别
除了使用DEFINE_LOG_CATEGORY宏，你还可以创建更灵活的自定义日志类别：
cpp复制DECLARE_LOG_CATEGORY_EXTERN(LogMyGameModule, Log, All);
DEFINE_LOG_CATEGORY(LogMyGameModule);
DECLARE_LOG_CATEGORY_EXTERN允许你在头文件中声明日志类别，然后在cpp文件中定义它。第三个参数All表示默认编译所有级别的日志。
4.2 结构化日志
UE4.26+支持结构化日志，可以附加额外的上下文信息：
cpp复制UE_LOGFMT(LogMyGame, Warning, "Player {PlayerName} has invalid health {Health}",
("PlayerName", PlayerName),
("Health", HealthValue));
这种格式更易读且支持日志分析工具。
4.3 日志过滤与分析
在大型项目中，日志量可能非常庞大。UE提供了几种过滤和分析方法：
- 在输出日志窗口中使用过滤器
- 使用
-logcmds="..."启动参数保存日志到文件 - 使用第三方工具如LogParser分析日志文件
4.4 蓝图中的日志
在蓝图中也可以输出日志，使用"Print String"节点：
- 设置"Print to Log"为true
- 选择适当的日志级别
- 勾选"Print to Screen"可在游戏中显示
5. 常见问题排查
5.1 日志不显示
如果日志没有按预期显示，检查以下方面：
- 确保日志类别已正确定义
- 检查
DefaultEngine.ini中的日志配置 - 确认没有在命令行中使用
-silent或-nullrhi等抑制日志的参数 - 打包版本默认会禁用Verbose和Log级别
5.2 日志性能问题
如果游戏因日志输出而变慢：
- 使用
STAT命令检查日志开销 - 减少高频循环中的日志输出
- 考虑使用
UE_LOG_ONCE宏避免重复输出相同消息
5.3 日志文件过大
处理大型日志文件的方法：
- 使用日志轮转：
-logcmds="rotate" - 设置最大文件大小：
-maxlogfilesize=1024 - 定期清理旧日志文件
6. 最佳实践建议
根据多年UE开发经验，以下日志使用建议值得参考：
- 合理分级：严格按事件严重性选择日志级别，避免滥用高等级日志
- 信息明确：每条日志应包含足够上下文，如对象ID、关键参数等
- 避免敏感信息：不要在日志中记录密码、密钥等敏感数据
- 统一格式：团队应约定一致的日志格式，便于后期分析
- 定期审查：定期检查日志输出，移除不再需要的调试日志
在大型项目中，良好的日志实践可以节省大量调试时间。我曾参与的一个MMO项目，因为初期没有规范日志使用，导致后期每天产生数十GB的日志数据，分析问题变得极其困难。后来我们实施了严格的日志规范，问题定位效率提升了数倍。
对于特别复杂的系统，建议建立专门的日志子系统，例如为网络模块设计包含数据包序列号、时间戳和连接状态的增强日志，这会为网络问题排查带来极大便利。