尧图网站建设 
第 26 章 常见问题与调试技巧摘要本章汇总了 VSG 开发中最常见的调试技巧与问题排查方法包括 Vulkan 验证层开启、RenderDoc 抓帧分析、内存泄漏排查、全教程高频坑速查表、构建期常见问题以及系统化的调试工作流建议可作为 VSG 开发的排错速查手册。本章定位把整套教程里最容易踩的坑集中到一页并给出验证层、RenderDoc、内存排查的实用方法。建议作为「排错速查」常备。26.1 开启 Vulkan 验证层验证层能在开发期抓出绝大多数 API 误用绑定不完整、布局不匹配、图像布局错误等。autotraitsvsg::WindowTraits::create(800,600,VSG Debug);traits-debugLayertrue;// 开启验证层在 Window::create 之前设置traits-apiDumpfalse;// 可选打印每个 Vulkan 调用autowindowvsg::Window::create(traits);或在 CMake 定义target_compile_definitions(my_app PRIVATE VSG_DEBUG)验证层需要 Vulkan SDK 安装且VK_LAYER_PATH指向 SDK 的bin层目录。用vulkaninfo确认驱动与层可用。验证层错误示例VUID-VkDescriptorSetLayoutBinding-descriptorType-00344开启验证层后常见的错误之一是描述符绑定类型不匹配。以下是一个典型的验证层错误日志Validation Error: [ VUID-VkDescriptorSetLayoutBinding-descriptorType-00344 ] Object 0: handle 0x1f3a5c0, type VK_OBJECT_TYPE_DEVICE; | MessageID 0x12345678 | vkCreateDescriptorSetLayout: binding #0 (index 0) is a VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER, but shader expects VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER. The Vulkan spec states: descriptorType must match the shaders declared descriptor type.错误含义VUIDVulkan 验证层唯一错误标识符用于定位规范条款。核心问题在DescriptorSetLayout的绑定 #0 处你声明的是VK_DESCRIPTOR_TYPE_UNIFORM_BUFFERUniform 缓冲区但着色器中对应的绑定点layout(binding 0) uniform sampler2D tex;期望的是VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER采样器纹理。根本原因VSG 的DescriptorSetLayout配置与 GLSL 着色器的layout(binding...)声明不匹配。VSG 代码修正方法检查着色器声明GLSL// 错误声明期望 Uniform Buffer但实际是采样器 layout(binding 0) uniform MyUniform { vec4 color; } ubo; // 正确声明匹配 Uniform Buffer layout(binding 0) uniform MyUniform { vec4 color; } ubo;修正 VSG 的 DescriptorSetLayout 创建// 错误配置使用了 CombinedImageSampler 但着色器期望 UniformBufferautosamplervsg::Sampler::create();autoimageInfovsg::ImageInfo::create(sampler,textureView,VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL);autodescriptorvsg::DescriptorImage::create(imageInfo,0,0,VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER);// 正确配置使用 UniformBuffer 类型autobufferInfovsg::BufferInfo::create(uniformBuffer);autodescriptorvsg::DescriptorBuffer::create(bufferInfo,0,0,VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER);确保 PipelineLayout 与 DescriptorSetLayout 一致autodescriptorSetLayoutvsg::DescriptorSetLayout::create({vsg::DescriptorSetLayoutBinding(0,VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER,1,VK_SHADER_STAGE_VERTEX_BIT)});autopipelineLayoutvsg::PipelineLayout::create(vsg::DescriptorSetLayouts{descriptorSetLayout},vsg::PushConstantRanges{});调试建议验证层会精确指出哪个绑定binding #类型不匹配对照检查该绑定的 VSG 代码与 GLSL 声明。使用vsg::ShaderStage::create()时确保传入的 GLSL 代码与DescriptorSetLayout的binding和descriptorType完全对应。如果使用vsg::GraphicsPipelineConfigurator检查config-descriptorSetLayout是否与着色器匹配。提示验证层错误信息通常包含VUID-前缀可在 Vulkan 规范 中搜索该 VUID 查看详细说明。26.2 用 RenderDoc 抓帧RenderDoc 是 Vulkan 调试利器用 RenderDoc 启动你的程序或注入捕获一帧F12 或 UI 触发在捕获里检查Render Passes是否就是第 12 章的RenderGraph每个 Pass 对应一个 RenderGraphPipeline / Vertex InputVertexInputState的 binding/attribute 是否与着色器一致第 7 章坑Descriptors绑定是否到位、DescriptorImage纹理是否正常第 10 章Textures / Buffers离屏 Pass 的中间结果第 20 章后处理。抓帧前建议开traits-debugLayertrue这样 RenderDoc 事件浏览器会显示验证层错误直接定位问题 Draw。RenderDoc 实战截图示例一张典型的 RenderDoc 捕获界面通常包含以下几个关键信息区域事件浏览器Event Browser位于界面左侧按时间顺序列出所有 Vulkan API 调用Draw、Dispatch、Copy 等。VSG 对应每个vkCmdDraw*对应 VSG 的一个Command节点执行。如果开启了debugLayertrue验证层错误会直接显示在对应事件旁可快速定位问题 Draw。管线状态Pipeline State位于界面中部或右侧展示当前选中 Draw 的完整管线配置。关键检查点Vertex Input核对binding、attribute与 VSG 的VertexInputState是否一致第 7 章常见坑。Descriptor Sets查看绑定的DescriptorSet布局、绑定的Buffer/Image资源是否正确。Shader Modules确认着色器代码、push constant范围与 VSG 的ShaderStage配置匹配。纹理查看器Texture Viewer显示当前绑定的纹理、渲染目标Render Target内容。VSG 应用检查离屏渲染的中间结果如第 20 章的后处理 Pass是否正确生成。确认DescriptorImage绑定的纹理格式、尺寸与着色器采样器期望的一致。Render Pass 与帧缓冲Render Pass Framebuffer展示当前 Render Pass 的附件Attachments、子通道Subpasses依赖关系。与 VSG 关联这里的每个 Render Pass 通常对应 VSG 的一个RenderGraph第 12 章。可验证附件数量、格式是否与RenderGraph的attachments配置一致。子通道依赖是否与RenderGraph的dependencies匹配。如何结合截图定位 VSG 渲染问题黑屏/花屏先选中出问题的 Draw在「Pipeline State」中检查Vertex Input→ 确认location、format与 GLSL 着色器声明一致。Descriptor Sets→ 查看绑定的纹理/缓冲区是否为空或格式错误。Shader Modules→ 确认着色器编译成功无undefined identifier错误。纹理显示异常在「Texture Viewer」中选中对应的纹理检查纹理内容是否正确如全黑、全白可能表示渲染未成功。核对纹理尺寸、格式是否与DescriptorImage创建时一致。性能瓶颈在「Event Browser」中观察 Draw Call 数量与分布过多的 Draw 可能源于未合批第 25 章优化建议。单个 Draw 耗时过长可检查绑定的纹理尺寸是否过大、着色器是否复杂。提示捕获前务必开启traits-debugLayer true这样 RenderDoc 会直接显示验证层警告/错误帮你快速定位到具体的 API 调用位置。26.3 内存泄漏排查CPU 侧vsg::Allocator::instance()-report(std::cout)看内存块是否只涨不跌第 23 章切ALLOCATOR_TYPE_NEW_DELETE AddressSanitizer 抓越界/重复释放ref_ptr循环引用两个对象互相ref_ptr持有 → 永不释放。反向/缓存指针用vsg::observer_ptr打破环GPU 侧RenderDoc 看Texture/Buffer 数量与大小避免每帧重建Buffer/Image大场景用DatabasePager限量第 18 章。26.4 全教程「高频坑」速查表章节坑正确做法5/9GraphicsPipelineConfigurator漏init()严格enableArray → init() → copyTo5编译后没updateViewercompile()后必须updateViewer(viewer, result)7顶点布局与着色器location不匹配VertexInputState的location/format/binding逐项对齐 GLSL7误用vsg::VertexIndex/vsg::VertexIndexBuffer用vsg::GeometryassignArrays/assignIndices本版本无这两个类11画面拉伸用window-extent2D()真实宽高比或交给createRenderGraphForView13vsg::read(x.gltf)返回 null链接vsgXchangefind_package target14用vsg::AnimationPathVSG 无此类型改用AnimationTransformSampler14动画不动用viewer-animationManager-play(animation)且帧循环含viewer-update()16模型不亮用光照感知ShaderSetView的RECORD_LIGHTS17vsgText找不到text已并入核心直接#include vsg/text/Text.h无需find_package17文字不显示挂入前调用text-setup()且font非空22ImGui 不响应加事件收集器CollectEvents到Viewer23内存只涨不跌检查悬空ref_ptr/ 循环引用用Allocator::report()26.5 构建期常见问题现象原因解决vsg/all.h: No such file没find_package(vsg)或没链接vsg::vsg确认安装并target_link_libraries(... vsg::vsg)找不到vsgXchange/vsgImGui没安装组件库单独克隆编译安装再find_package链接报错unresolved external混用 Debug/Release 或 ABI 不一致统一构建类型Release 配 Release运行时提示无 Vulkan缺驱动/ICD安装显卡厂商 Vulkan 驱动用vulkaninfo验证26.6 调试工作流建议开发期常开验证层debugLayer/VSG_DEBUG把错误消灭在编译/启动阶段黑屏先查绑定着色器location↔VertexInputState↔DescriptorSetLayout三者对齐仍不行抓一帧RenderDoc 看 Pass / Pipeline / Descriptor / Texture性能问题先量化Instrumentation RenderDoc 看 Draw Call 与显存再按第 25 章优化。26.7 小结验证层debugLayer/VSG_DEBUG是第一步防线RenderDoc 看 Pass/Pipeline/Descriptor/Texture定位绑定与后处理问题内存分 CPUAllocatorobserver_ptr与 GPURenderDoc 限量两条线全教程坑已汇总成速查表遇到异常先来这查。26.8 延伸阅读第 25 章《性能优化指南》用工具量化后再优化第 12 章《RenderGraph 与 CommandGraph》RenderDoc 里看到的 Pass 从何而来第 23 章《内存管理》分配器与泄漏排查细节。26.9 常见问题快速解答FAQ1. 开启 debugLayer 后程序崩溃或报层找不到错误如何解决步骤排查确认 Vulkan SDK 安装运行vulkaninfo或vulkaninfo --summary确保能正常输出设备信息。检查环境变量设置VK_LAYER_PATH指向 Vulkan SDK 的层目录如C:\VulkanSDK\1.3.xxx.x\Bin或/usr/share/vulkan/explicit_layer.d。验证层可用性在vulkaninfo输出的 “Layers” 部分查看VK_LAYER_KHRONOS_validation是否列出。VSG 编译选项若使用 CMake 定义VSG_DEBUG确保编译时 Vulkan SDK 头文件路径正确。降级尝试若仍失败可尝试关闭apiDump设traits-apiDump false或仅开启部分验证层特性。2. RenderDoc 捕获不到我的 VSG 应用程序怎么办检查清单以 RenderDoc 启动从 RenderDoc UI 的 “Launch Application” 标签页启动你的可执行文件不要直接双击运行。确认 Vulkan 渲染RenderDoc 仅支持 Vulkan、D3D 等图形 API确保程序使用 Vulkan 后端VSG 默认即是。检查捕获热键RenderDoc 默认捕获热键是 F12可在设置中修改。确保程序窗口焦点在捕获瞬间未被其他窗口抢占。验证层干扰若开启debugLayer后 RenderDoc 无法注入可临时关闭验证层traits-debugLayer false再尝试捕获。管理员权限在 Windows 上以管理员身份运行 RenderDoc 可能解决注入权限问题。3. 如何确认内存泄漏是 CPU 侧还是 GPU 侧诊断步骤CPU 侧检查在程序运行期间定期调用vsg::Allocator::instance()-report(std::cout)观察Allocated blocks数量是否持续增长。使用 AddressSanitizerLinux/macOS或 Visual Studio 内存诊断工具Windows检测越界访问、重复释放。检查ref_ptr循环引用将非拥有关系的指针改为observer_ptr。GPU 侧检查使用 RenderDoc 捕获一帧在 “Resource Manager” 标签页查看 Texture、Buffer 的数量和总大小。如果每帧都新增且不释放则存在 GPU 泄漏。避免每帧创建新的vsg::Buffer、vsg::Image或vsg::DescriptorSet尽量复用。对于动态数据如 Uniform Buffer使用vsg::BufferInfo配合vsg::CopyAndReleaseBuffer进行更新而非重建。综合判断若 CPU 内存持续增长而 GPU 资源稳定 → 重点排查ref_ptr持有、容器未清理、静态变量累积。若 GPU 资源每帧增加 → 检查渲染循环中是否有未释放的vsg::createBuffer、vsg::createImage调用。二者均增长 → 可能为同一资源在 CPU/GPU 两端均未释放如vsg::Buffer连带其 GPU 内存。教程完。本套教程从环境搭建、核心概念、场景实战、高级特性到完整项目所有 API 均对照本仓库include/vsg/源码核实。祝你用 VSG 写出高性能的 Vulkan 应用 VulkanSceneGraph学习教程（二十六）
第 26 章 常见问题与调试技巧摘要本章汇总了 VSG 开发中最常见的调试技巧与问题排查方法包括 Vulkan 验证层开启、RenderDoc 抓帧分析、内存泄漏排查、全教程高频坑速查表、构建期常见问题以及系统化的调试工作流建议可作为 VSG 开发的排错速查手册。本章定位把整套教程里最容易踩的坑集中到一页并给出验证层、RenderDoc、内存排查的实用方法。建议作为「排错速查」常备。26.1 开启 Vulkan 验证层验证层能在开发期抓出绝大多数 API 误用绑定不完整、布局不匹配、图像布局错误等。autotraitsvsg::WindowTraits::create(800,600,VSG Debug);traits-debugLayertrue;// 开启验证层在 Window::create 之前设置traits-apiDumpfalse;// 可选打印每个 Vulkan 调用autowindowvsg::Window::create(traits);或在 CMake 定义target_compile_definitions(my_app PRIVATE VSG_DEBUG)验证层需要 Vulkan SDK 安装且VK_LAYER_PATH指向 SDK 的bin层目录。用vulkaninfo确认驱动与层可用。验证层错误示例VUID-VkDescriptorSetLayoutBinding-descriptorType-00344开启验证层后常见的错误之一是描述符绑定类型不匹配。以下是一个典型的验证层错误日志Validation Error: [ VUID-VkDescriptorSetLayoutBinding-descriptorType-00344 ] Object 0: handle 0x1f3a5c0, type VK_OBJECT_TYPE_DEVICE; | MessageID 0x12345678 | vkCreateDescriptorSetLayout: binding #0 (index 0) is a VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER, but shader expects VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER. The Vulkan spec states: descriptorType must match the shaders declared descriptor type.错误含义VUIDVulkan 验证层唯一错误标识符用于定位规范条款。核心问题在DescriptorSetLayout的绑定 #0 处你声明的是VK_DESCRIPTOR_TYPE_UNIFORM_BUFFERUniform 缓冲区但着色器中对应的绑定点layout(binding 0) uniform sampler2D tex;期望的是VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER采样器纹理。根本原因VSG 的DescriptorSetLayout配置与 GLSL 着色器的layout(binding...)声明不匹配。VSG 代码修正方法检查着色器声明GLSL// 错误声明期望 Uniform Buffer但实际是采样器 layout(binding 0) uniform MyUniform { vec4 color; } ubo; // 正确声明匹配 Uniform Buffer layout(binding 0) uniform MyUniform { vec4 color; } ubo;修正 VSG 的 DescriptorSetLayout 创建// 错误配置使用了 CombinedImageSampler 但着色器期望 UniformBufferautosamplervsg::Sampler::create();autoimageInfovsg::ImageInfo::create(sampler,textureView,VK_IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL);autodescriptorvsg::DescriptorImage::create(imageInfo,0,0,VK_DESCRIPTOR_TYPE_COMBINED_IMAGE_SAMPLER);// 正确配置使用 UniformBuffer 类型autobufferInfovsg::BufferInfo::create(uniformBuffer);autodescriptorvsg::DescriptorBuffer::create(bufferInfo,0,0,VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER);确保 PipelineLayout 与 DescriptorSetLayout 一致autodescriptorSetLayoutvsg::DescriptorSetLayout::create({vsg::DescriptorSetLayoutBinding(0,VK_DESCRIPTOR_TYPE_UNIFORM_BUFFER,1,VK_SHADER_STAGE_VERTEX_BIT)});autopipelineLayoutvsg::PipelineLayout::create(vsg::DescriptorSetLayouts{descriptorSetLayout},vsg::PushConstantRanges{});调试建议验证层会精确指出哪个绑定binding #类型不匹配对照检查该绑定的 VSG 代码与 GLSL 声明。使用vsg::ShaderStage::create()时确保传入的 GLSL 代码与DescriptorSetLayout的binding和descriptorType完全对应。如果使用vsg::GraphicsPipelineConfigurator检查config-descriptorSetLayout是否与着色器匹配。提示验证层错误信息通常包含VUID-前缀可在 Vulkan 规范 中搜索该 VUID 查看详细说明。26.2 用 RenderDoc 抓帧RenderDoc 是 Vulkan 调试利器用 RenderDoc 启动你的程序或注入捕获一帧F12 或 UI 触发在捕获里检查Render Passes是否就是第 12 章的RenderGraph每个 Pass 对应一个 RenderGraphPipeline / Vertex InputVertexInputState的 binding/attribute 是否与着色器一致第 7 章坑Descriptors绑定是否到位、DescriptorImage纹理是否正常第 10 章Textures / Buffers离屏 Pass 的中间结果第 20 章后处理。抓帧前建议开traits-debugLayertrue这样 RenderDoc 事件浏览器会显示验证层错误直接定位问题 Draw。RenderDoc 实战截图示例一张典型的 RenderDoc 捕获界面通常包含以下几个关键信息区域事件浏览器Event Browser位于界面左侧按时间顺序列出所有 Vulkan API 调用Draw、Dispatch、Copy 等。VSG 对应每个vkCmdDraw*对应 VSG 的一个Command节点执行。如果开启了debugLayertrue验证层错误会直接显示在对应事件旁可快速定位问题 Draw。管线状态Pipeline State位于界面中部或右侧展示当前选中 Draw 的完整管线配置。关键检查点Vertex Input核对binding、attribute与 VSG 的VertexInputState是否一致第 7 章常见坑。Descriptor Sets查看绑定的DescriptorSet布局、绑定的Buffer/Image资源是否正确。Shader Modules确认着色器代码、push constant范围与 VSG 的ShaderStage配置匹配。纹理查看器Texture Viewer显示当前绑定的纹理、渲染目标Render Target内容。VSG 应用检查离屏渲染的中间结果如第 20 章的后处理 Pass是否正确生成。确认DescriptorImage绑定的纹理格式、尺寸与着色器采样器期望的一致。Render Pass 与帧缓冲Render Pass Framebuffer展示当前 Render Pass 的附件Attachments、子通道Subpasses依赖关系。与 VSG 关联这里的每个 Render Pass 通常对应 VSG 的一个RenderGraph第 12 章。可验证附件数量、格式是否与RenderGraph的attachments配置一致。子通道依赖是否与RenderGraph的dependencies匹配。如何结合截图定位 VSG 渲染问题黑屏/花屏先选中出问题的 Draw在「Pipeline State」中检查Vertex Input→ 确认location、format与 GLSL 着色器声明一致。Descriptor Sets→ 查看绑定的纹理/缓冲区是否为空或格式错误。Shader Modules→ 确认着色器编译成功无undefined identifier错误。纹理显示异常在「Texture Viewer」中选中对应的纹理检查纹理内容是否正确如全黑、全白可能表示渲染未成功。核对纹理尺寸、格式是否与DescriptorImage创建时一致。性能瓶颈在「Event Browser」中观察 Draw Call 数量与分布过多的 Draw 可能源于未合批第 25 章优化建议。单个 Draw 耗时过长可检查绑定的纹理尺寸是否过大、着色器是否复杂。提示捕获前务必开启traits-debugLayer true这样 RenderDoc 会直接显示验证层警告/错误帮你快速定位到具体的 API 调用位置。26.3 内存泄漏排查CPU 侧vsg::Allocator::instance()-report(std::cout)看内存块是否只涨不跌第 23 章切ALLOCATOR_TYPE_NEW_DELETE AddressSanitizer 抓越界/重复释放ref_ptr循环引用两个对象互相ref_ptr持有 → 永不释放。反向/缓存指针用vsg::observer_ptr打破环GPU 侧RenderDoc 看Texture/Buffer 数量与大小避免每帧重建Buffer/Image大场景用DatabasePager限量第 18 章。26.4 全教程「高频坑」速查表章节坑正确做法5/9GraphicsPipelineConfigurator漏init()严格enableArray → init() → copyTo5编译后没updateViewercompile()后必须updateViewer(viewer, result)7顶点布局与着色器location不匹配VertexInputState的location/format/binding逐项对齐 GLSL7误用vsg::VertexIndex/vsg::VertexIndexBuffer用vsg::GeometryassignArrays/assignIndices本版本无这两个类11画面拉伸用window-extent2D()真实宽高比或交给createRenderGraphForView13vsg::read(x.gltf)返回 null链接vsgXchangefind_package target14用vsg::AnimationPathVSG 无此类型改用AnimationTransformSampler14动画不动用viewer-animationManager-play(animation)且帧循环含viewer-update()16模型不亮用光照感知ShaderSetView的RECORD_LIGHTS17vsgText找不到text已并入核心直接#include vsg/text/Text.h无需find_package17文字不显示挂入前调用text-setup()且font非空22ImGui 不响应加事件收集器CollectEvents到Viewer23内存只涨不跌检查悬空ref_ptr/ 循环引用用Allocator::report()26.5 构建期常见问题现象原因解决vsg/all.h: No such file没find_package(vsg)或没链接vsg::vsg确认安装并target_link_libraries(... vsg::vsg)找不到vsgXchange/vsgImGui没安装组件库单独克隆编译安装再find_package链接报错unresolved external混用 Debug/Release 或 ABI 不一致统一构建类型Release 配 Release运行时提示无 Vulkan缺驱动/ICD安装显卡厂商 Vulkan 驱动用vulkaninfo验证26.6 调试工作流建议开发期常开验证层debugLayer/VSG_DEBUG把错误消灭在编译/启动阶段黑屏先查绑定着色器location↔VertexInputState↔DescriptorSetLayout三者对齐仍不行抓一帧RenderDoc 看 Pass / Pipeline / Descriptor / Texture性能问题先量化Instrumentation RenderDoc 看 Draw Call 与显存再按第 25 章优化。26.7 小结验证层debugLayer/VSG_DEBUG是第一步防线RenderDoc 看 Pass/Pipeline/Descriptor/Texture定位绑定与后处理问题内存分 CPUAllocatorobserver_ptr与 GPURenderDoc 限量两条线全教程坑已汇总成速查表遇到异常先来这查。26.8 延伸阅读第 25 章《性能优化指南》用工具量化后再优化第 12 章《RenderGraph 与 CommandGraph》RenderDoc 里看到的 Pass 从何而来第 23 章《内存管理》分配器与泄漏排查细节。26.9 常见问题快速解答FAQ1. 开启 debugLayer 后程序崩溃或报层找不到错误如何解决步骤排查确认 Vulkan SDK 安装运行vulkaninfo或vulkaninfo --summary确保能正常输出设备信息。检查环境变量设置VK_LAYER_PATH指向 Vulkan SDK 的层目录如C:\VulkanSDK\1.3.xxx.x\Bin或/usr/share/vulkan/explicit_layer.d。验证层可用性在vulkaninfo输出的 “Layers” 部分查看VK_LAYER_KHRONOS_validation是否列出。VSG 编译选项若使用 CMake 定义VSG_DEBUG确保编译时 Vulkan SDK 头文件路径正确。降级尝试若仍失败可尝试关闭apiDump设traits-apiDump false或仅开启部分验证层特性。2. RenderDoc 捕获不到我的 VSG 应用程序怎么办检查清单以 RenderDoc 启动从 RenderDoc UI 的 “Launch Application” 标签页启动你的可执行文件不要直接双击运行。确认 Vulkan 渲染RenderDoc 仅支持 Vulkan、D3D 等图形 API确保程序使用 Vulkan 后端VSG 默认即是。检查捕获热键RenderDoc 默认捕获热键是 F12可在设置中修改。确保程序窗口焦点在捕获瞬间未被其他窗口抢占。验证层干扰若开启debugLayer后 RenderDoc 无法注入可临时关闭验证层traits-debugLayer false再尝试捕获。管理员权限在 Windows 上以管理员身份运行 RenderDoc 可能解决注入权限问题。3. 如何确认内存泄漏是 CPU 侧还是 GPU 侧诊断步骤CPU 侧检查在程序运行期间定期调用vsg::Allocator::instance()-report(std::cout)观察Allocated blocks数量是否持续增长。使用 AddressSanitizerLinux/macOS或 Visual Studio 内存诊断工具Windows检测越界访问、重复释放。检查ref_ptr循环引用将非拥有关系的指针改为observer_ptr。GPU 侧检查使用 RenderDoc 捕获一帧在 “Resource Manager” 标签页查看 Texture、Buffer 的数量和总大小。如果每帧都新增且不释放则存在 GPU 泄漏。避免每帧创建新的vsg::Buffer、vsg::Image或vsg::DescriptorSet尽量复用。对于动态数据如 Uniform Buffer使用vsg::BufferInfo配合vsg::CopyAndReleaseBuffer进行更新而非重建。综合判断若 CPU 内存持续增长而 GPU 资源稳定 → 重点排查ref_ptr持有、容器未清理、静态变量累积。若 GPU 资源每帧增加 → 检查渲染循环中是否有未释放的vsg::createBuffer、vsg::createImage调用。二者均增长 → 可能为同一资源在 CPU/GPU 两端均未释放如vsg::Buffer连带其 GPU 内存。教程完。本套教程从环境搭建、核心概念、场景实战、高级特性到完整项目所有 API 均对照本仓库include/vsg/源码核实。祝你用 VSG 写出高性能的 Vulkan 应用