Unreal Engine

核心用途

该技能为Unreal Engine C++开发者提供系统性避坑指南，聚焦引擎特有的技术陷阱：垃圾回收机制中UPROPERTY宏的必要性、网络复制的权威性模型、资产引用的硬/软指针策略，以及Actor生命周期各阶段的正确使用场景。

显著优点

1. 机制深度覆盖：不仅给出方案，更解释底层原理——如GC如何通过反射系统追踪UObject、CDO（Class Default Object）为何不能在构造函数中访问World等
2. 性能意识导向：明确区分Tick与Timer的适用场景，强调TSoftObjectPtr的内存优化价值，符合UE大型项目开发规范
3. 版本兼容性强：涉及的API（TSharedPtr、UFUNCTION宏等）为引擎核心机制，跨版本稳定性高

潜在局限

1. 抽象层级跳跃：同时涉及C++底层（智能指针）、反射系统（UHT宏）和蓝图交互，对初学者认知负荷较大
2. 语境依赖严重：部分建议（如"Hot reload corrupts Blueprints"）是特定工作流痛点，非普适真理；现代UE版本已改进热重载稳定性
3. 缺少错误示例对比：仅陈述正确做法，未展示错误代码及其崩溃现场，学习曲线陡峭
4. 网络复制简化：Role/RemoteRole检查在UE5中已被GetLocalRole()/GetRemoteRole()取代，存在版本滞后风险

适合人群

• 具备C++基础但初次接触UE反射系统的开发者
• 从蓝图转向C++、需理解底层GC机制的中级用户
• 排查内存泄漏、网络同步异常等疑难问题的技术负责人

常规风险

• 过度防御性编码：盲目添加UPROPERTY可能导致不必要的GC跟踪开销；需理解"必要引用"与"临时引用"的边界
• 权威模式误用：客户端绕过HasAuthority()执行逻辑将引发不同步，且该技能未强调作弊防护的服务器验证必要性
• 软引用异步陷阱：AsyncLoad回调管理不当可能导致访问未加载资产，需配合FStreamableManager使用

使用建议

建议与官方文档《Unreal Engine C++ Reference》并行查阅，关键API（如Replication系统）以引擎源码为准。生产代码中涉及网络复制时，务必补充服务器端验证逻辑。

核心用途

本 Skill 是一份针对 Unreal Engine C++ 开发的最佳实践速查手册，聚焦开发者最易踩坑的核心机制，提供可落地的代码级建议。

显著优点

• 覆盖面精准：直击 Unreal 开发的六大高风险区——垃圾回收、宏标记、Actor 生命周期、Tick 性能、网络复制、资产引用，均为生产环境高频问题
• 建议颗粒度细：不仅指出「不要做什么」，更给出「应该用什么替代」（如 NewObject<T>() 替代 raw new、TSoftObjectPtr 替代硬引用）
• 性能与架构兼顾：同时关注运行期性能（Tick 禁用、FName 哈希）与项目架构健康度（软引用管理、内存指针规范）
• 安全纯净：纯 Markdown 文档，无可执行代码、无网络调用、无敏感数据，S+ 顶级安全评级

潜在局限

• 版本依赖风险：Unreal Engine 迭代频繁（如 UE5 的 Lumen、World Partition 等新系统），部分建议可能随版本演进需调整
• 非官方背书：来源为个人开发者（T3 可信度），未与 Epic Games 官方文档同步，建议与官方白皮书交叉验证
• 缺乏上下文示例：作为速查表，未提供完整工程案例，初学者可能难以判断具体场景的适用性
• 未覆盖 Blueprint 独占特性：侧重 C++ 开发，对纯 Blueprint 项目的直接帮助有限

适合人群

• 中高级 Unreal C++ 开发者：需要快速回顾最佳实践或排查诡异崩溃（如 GC 导致的悬空指针）
• 技术 Leader/架构师：制定团队代码规范时作为参考基线
• 从 Unity 或其他引擎迁移者：理解 Unreal 独有的 UObject 系统与反射机制

常规风险

• 误用建议导致编译错误：如错误理解 UFUNCTION(Server) 的 Reliable/Unreliable 标记可能引发网络同步问题
• 过度优化：盲目禁用 Tick 可能破坏依赖时序的游戏逻辑
• 版本不匹配：UE4 与 UE5 在垃圾回收、网络同步层有差异，需确认目标引擎版本

使用建议

建议作为 IDE 旁的常驻参考文档，在编码阶段快速检索；关键架构决策前，务必对照官方文档与项目实际测试验证。