确认 Vulkan 环境是否正确：Windows 需安装 LunarG 官方 SDK 并设置 VULKAN_SDK 环境变量；Linux 需同时安装 vulkan-loader 和对应驱动的 ICD；运行 vulkaninfo 验证，失败则 vkCreateInstance 必报错。
怎么确认 Vulkan 开发环境装对了
没装对 SDK 或驱动，vkCreateInstance 直接返回 VK_ERROR_INCOMPATIBLE_DRIVER 或根本找不到函数地址。这不是代码问题，是环境断层。
实操建议：
- Windows 下必须装 LunarG 官方
VulkanSDK（别只靠显卡驱动自带的运行时），且确保VULKAN_SDK环境变量指向 SDK 根目录 - Linux 需同时装
vulkan-loader（提供libvulkan.so）和对应驱动的 ICD（如nvidia-vulkan-icd或mesa-vulkan-drivers），缺一不可 - 用命令行跑
vulkaninfo—— 如果报错或输出为空，vkCreateInstance必挂，别往下写渲染循环
vkCreateInstance 失败最常见的三个原因
90% 的初学者卡在这一步，不是语法错，是参数填得不“诚实”。
常见错误现象：VK_ERROR_LAYER_NOT_PRESENT、VK_ERROR_EXTENSION_NOT_PRESENT、返回 nullptr 但无错误码（说明 loader 没加载成功）。
立即学习“C++免费学习笔记（深入）”；
实操建议：
- 不要硬写
"VK_LAYER_LUNARG_standard_validation"—— 这个 layer 在新 SDK 中已废弃，改用"VK_LAYER_KHRONOS_validation"，且必须先调vkEnumerateInstanceLayerProperties确认存在 -
vkEnumerateInstanceExtensionProperties(nullptr, ...)必须调一次，检查"VK_KHR_get_physical_device_properties2"和"VK_EXT_debug_utils"是否在列表里，别凭记忆写 - Windows 下若用 MinGW 编译，确保链接
vulkan-1.lib（MSVC）或-lvulkan（GCC），且动态库vulkan-1.dll在 PATH 或可执行目录中
如何让 vkQueueSubmit 不卡死也不报 VK_ERROR_DEVICE_LOST
提交命令后画面不动、程序假死，或者突然崩出 VK_ERROR_DEVICE_LOST，大概率是同步逻辑没闭环，不是 GPU 挂了。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
使用场景：刚建好 command buffer，填了 vkCmdDraw，就急着 submit。
实操建议：
- submit 前必须保证 command buffer 已结束记录：
vkEndCommandBuffer不能漏，否则行为未定义 - 哪怕只画一帧，也要配一个
VkFence：submit 时传入fence，之后调vkWaitForFences等它完成，否则 GPU 可能还在读旧数据 - 别复用正在被 GPU 执行的 command buffer —— 检查
vkResetCommandBuffer前是否已通过vkGetFenceStatus或vkWaitForFences确认上一轮执行完
调试信息打不出来？VK_EXT_debug_utils 不生效的硬核排查点
注册了 vkCreateDebugUtilsMessengerEXT 回调，但 vkCmdPipelineBarrier 写错格式也没提示，说明 debug messenger 根本没挂上。
参数差异：这个 extension 分 instance 和 device 两级，debug messenger 是 instance 级的，但很多人误以为要等 vkCreateDevice 后才配。
实操建议：
- 必须在
vkCreateInstance的pEnabledExtensionNames里显式加"VK_EXT_debug_utils"，否则vkCreateDebugUtilsMessengerEXT函数地址为nullptr - 回调函数里别直接
printf—— Vulkan 可能在任意线程调你，printf 不是线程安全的；先存日志再统一刷，或用std::atomic计数器简单标记 - 验证是否生效：故意传个非法
imageLayout给vkCmdPipelineBarrier，如果没报错，说明 messenger 没触发，回头检查 instance 创建时的 extension 列表和函数地址获取流程
最易被忽略的是：Vulkan 的 validation layers 默认不开启任何检查级别，即使装了 SDK、启用了 layer，也得在创建 messenger 时传 messageSeverity = VK_DEBUG_UTILS_MESSAGE_SEVERITY_WARNING_BIT_EXT | VK_DEBUG_UTILS_MESSAGE_SEVERITY_ERROR_BIT_EXT，否则连 warning 都不吐。
