Using Vulkan -- Common Pitfalls for New Vulkan Developers

校验层

开发阶段务必开启校验层（Validation Layers），它是排查 Vulkan API 使用错误的核心工具，可检测参数合法性、对象生命周期、线程违规等问题。可通过输出日志中是否包含Debug Messenger Added确认校验层已启用。更多信息参考 Vulkan SDK 中的层文档。

Vulkan 是一套工具集

Vulkan 中多数问题存在多种解决方式，各有优劣，几乎不存在 “完美方案”，过度追求最优解通常徒劳无功。遇到问题时，优先实现满足当前需求、不过度复杂的可行方案。Vulkan 规范适合查阅细节，但不适合作为实践指南，可参考本文档、硬件厂商最佳实践、教程等外部资源。对不同方案进行性能剖析，是确定最终方案的重要环节。

命令缓冲区录制

早期 Vulkan 教程常建议一次性录制命令缓冲区并反复复用，但实践中复用难以达到宣传的性能收益，反而会显著增加开发与维护成本。尽管复用计算结果是常见优化手段，但场景中对象动态增删、视锥体剔除等会导致逐帧绘制命令变化，使命令缓冲区复用成为设计难题，需要缓存机制与状态管理来判断是否需要重新录制。建议：逐帧重新录制全新的命令缓冲区。性能不足时可采用多线程录制，或对后处理等不变绘制使用二级命令缓冲区。

多管线

图形VkPipeline包含执行绘制所需的全部状态组合。使用不同着色器、混合模式、顶点布局等绘制场景时，每种组合都需要独立管线。管线创建与绘制间切换存在开销，合理做法是仅在需要时创建与切换管线。过度使用复杂技巧进一步减少管线数量，会增加复杂度且不一定带来收益。大型引擎可能需要这样做，但普通项目中管线通常不是瓶颈。使用管线缓存（Pipeline Cache）可降低开销，无需引入复杂方案。

按交换链图像重复创建资源

帧流水线是常用性能优化手段：同时渲染多帧，每帧使用独立资源副本，减少资源竞争以降低延迟。简单实现会为交换链中每张图像复制一份资源，这容易导致误区：认为渲染资源必须与交换链图像一一对应复制。命令缓冲区、信号量等资源适合逐帧复制，但统一缓冲区、逐帧更新数据等资源通常只需 2 份副本，部分资源甚至无需复制。Vulkan 灵活性很高，开发者可按需选择复制粒度。

每个队列族创建多个队列

部分硬件平台的每个队列族支持多个VkQueue，可从不同队列向同一队列族提交任务，这在部分场景下有用。但创建与使用额外队列不一定更好，具体性能建议参考硬件厂商最佳实践指南。

描述符集

描述符集（Descriptor Sets）用于按用途与更新频率分组着色器使用的数据。Vulkan 规范要求硬件至少支持 4 个描述符集，多数硬件支持至少 8 个。在合理场景下，完全可以使用多个描述符集，几乎没有限制。

正确的 API 使用习惯

校验层无法捕获所有错误，以下良好习惯可避免出现异常行为：

• 初始化所有变量与结构体
• 为每个结构体设置正确的sType
• 正确使用pNext链，无需时置空
• Vulkan 中没有默认值
• 使用正确的枚举、VkFlag与位掩码值
• 考虑使用类型安全的 Vulkan 封装库，例如 C++ 的Vulkan.hpp
• 检查函数返回值，例如VkResult
• 在合适位置调用清理函数