需用vkCreateRayTracingPipelinesKHR创建光线追踪管线，构造VkRayTracingPipelineCreateInfoKHR时须指定stageCount/pStages定义着色器阶段，并以groupCount/pGroups显式组织raygen/miss/hit等组，每组type需合法且generalShader等索引不得越界，同时确保启用VK_KHR_ray_tracing_pipeline等扩展。
如何创建 VkRayTracingPipelineCreateInfoKHR 并绑定着色器
光线追踪管线不是靠 vkCreateGraphicsPipelines 或 vkCreateComputePipelines 创建的，必须用扩展函数 vkCreateRayTracingPipelinesKHR。前提是已启用 VK_KHR_ray_tracing_pipeline 和相关设备扩展（如 VK_KHR_acceleration_structure）。
关键点在于构造 VkRayTracingPipelineCreateInfoKHR：它不接受传统 pipeline 的 stageCount + pStages，而是用 stageCount + pStages 描述着色器阶段，再用 groupCount + pGroups 显式组织“着色器组”（ray generation / closest hit / miss / callable 等）。每个组通过 type 字段标识用途，且必须引用 pStages 中已声明的 module 和 name。
-
VkPipelineShaderStageCreateInfo中的module必须是 SPIR-V 编译自 GLSL 使用#extension GL_EXT_ray_tracing : require的着色器，且入口名（pName）需与组定义中一致 - Ray generation 组只能有一个，且必须存在；miss 和 closest hit 组可多个，但调用时靠索引（如
traceRayEXT的missIndex）定位 - 若漏掉
VK_SHADER_STAGE_RAYGEN_BIT_KHR对应的 stage，或组中generalShader指向不存在的 stage index，vkCreateRayTracingPipelinesKHR会直接返回VK_ERROR_INITIALIZATION_FAILED
为什么加速结构（Acceleration Structure）不能在管线里直接绑定
光线追踪管线本身不持有 BLAS/TLAS；它只约定着色器里用 accelerationStructureEXT 变量访问。实际绑定发生在绘制时——通过 descriptor set 提供 VkWriteDescriptorSetAccelerationStructureKHR 写入 TLAS handle，并在 shader 中用 traceRayEXT 调用。
常见错误是以为像 vertex buffer 那样在 pipeline state 里设置，结果 trace 总返回空命中。TLAS handle 是运行时生成的、不可序列化的值，必须在每帧（或每次更新后）重新写入 descriptor。
- descriptor set layout 中对应 binding 必须声明为
VK_DESCRIPTOR_TYPE_ACCELERATION_STRUCTURE_KHR - 写入 descriptor 时，
accelerationStructureCount必须为 1，pAccelerationStructures指向一个VkAccelerationStructureKHRhandle 数组（哪怕只传一个） - 若 TLAS 尚未构建完成（
vkBuildAccelerationStructuresKHR未提交或未同步），trace 行为未定义，可能 crash 或静默失败
如何正确编译和加载光线追踪着色器（.spv）
GLSL 光线追踪着色器不能用普通 glslangValidator 默认选项编译。必须显式启用扩展并指定目标环境：
glslc -fshader-stage=raygen --target-env=vulkan1.2 raygen.rgen -o raygen.spv glslc -fshader-stage=closesthit --target-env=vulkan1.2 closesthit.rchit -o closesthit.spv
遗漏 --target-env=vulkan1.2 会导致生成的 SPIR-V 缺少 OpExtension "SPV_KHR_ray_tracing"，驱动拒绝加载，vkCreateShaderModule 返回 VK_ERROR_INVALID_SHADER_NV（即使用的是 KHR 扩展）。
-
.rgen/.rchit/.rmiss后缀只是习惯，关键是-fshader-stage=参数值必须匹配着色器内#pragma shader_stage(…)或#version 460 core+#extension GL_EXT_ray_tracing - 着色器中访问顶点/索引数据需通过
accelerationStructureEXT+traceRayEXT回调，不能像 rasterization 那样用vertexIndex直接读取 buffer —— 这是初学者最常卡住的地方 - 如果用
glslangValidator（旧工具），必须加-D VK_KHR_ray_tracing且确保版本 ≥ 10.1.0；新版一律推荐glslc
管线创建失败时怎么快速定位 VK_ERROR_INITIALIZATION_FAILED
这个错误码几乎总是源于 VkRayTracingPipelineCreateInfoKHR 结构体字段非法，而非驱动不支持。不要急着查扩展是否启用，先检查这几项：
-
groupCount是否大于 0，且每个VkRayTracingShaderGroupCreateInfoKHR的type是否为合法枚举值（VK_RAY_TRACING_SHADER_GROUP_TYPE_GENERAL_KHR/_PROCEDURAL_HIT_GROUP_KHR/_GENERAL_KHR） -
generalShader（对 general 组）或closestHitShader（对 hit 组）是否越界 —— 它们是pStages数组的下标，不是 shader module 的 index -
maxRecursionDepth是否 ≤ 设备VkPhysicalDeviceRayTracingPipelinePropertiesKHR::maxRayRecursionDepth（通常为 31，设成 32 就失败） - 所有着色器 stage 的
module是否已成功vkCreateShaderModule，且未被提前vkDestroyShaderModule
最容易被忽略的是：TLAS 构建和管线创建没有先后依赖关系，但 descriptor 更新和 trace 调用有严格顺序 —— 如果你把 TLAS 构建放在管线创建之后，又没做 fence 同步，那 trace 时拿到的 handle 是无效的。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
