审查 Unity 6+ URP Render Graph…

当你需要审查或验证一个使用 Render Graph API 的 Unity 6+ URP ScriptableRendererFeature 及其 Pass 实现是否正确时，按以下清单逐项排查。

适用场景

解决思路

1. 按固定输出结构给出审查结果：1) 验证总结；2) 已确认问题（有代码直接支撑）；3) 可能的问题/风险假设（依赖缺失上下文）；4) 推荐修复（最小化针对性修改）；5) 修正后的代码片段；6) 缺失信息（需要哪些信息才能更高置信度验证）。
2. 材质绑定检查：确认材质声明清晰、序列化材质正确暴露、材质正确传入 Pass、必要的 null 处理存在、声明的材质确实被使用；确保执行前所有必需的材质输入都已绑定，尤其是当 shader 期望主输入纹理时必须显式绑定主输入纹理，辅助纹理和参数纹理也要显式绑定，且纹理/属性绑定与 shader 期望的属性名一致。
3. 材质绑定问题判定：材质被声明或传入但未使用；只绑定了次要纹理/参数却遗漏主输入纹理；绑定了 mask/noise/辅助纹理却没绑定主 color/input 纹理；假设 shader 属性存在却未设置；属性名不一致或含糊；在 Pass 模式要求显式绑定时依赖隐式主纹理绑定。
4. 材质绑定推荐模式：1) 清晰创建或赋值材质；2) 显式绑定主源纹理；3) 显式绑定所有辅助纹理；4) 属性名一致且有意图；5) 处理或报告 null/缺失资源情况。
5. 纹理资源接线检查：区分采样的/读取的纹理、写入目标、辅助纹理；用 UseTexture(...) 的纹理应适合读取访问；用 SetRenderAttachment(...) 的纹理应适合作为写入目标；源、目标、辅助资源不能混淆；所有预期纹理都显式接线；涉及材质时纹理属性名显式且一致；不得凭空假设纹理可用；多纹理资源使用要显式处理而非隐式。
6. 纹理资源接线问题判定：本应作为输入/读取资源的纹理被当作写入目标且无正当理由；目标/写入目标与采样输入混淆；辅助纹理未清晰来源或接线就使用；Pass 设置中缺少必需纹理资源；读/写资源角色含糊或不一致。
7. 执行结构/静态渲染函数检查：渲染函数必须声明为 static；执行结构匹配目标 Pass 类型和 API 风格；PassData 正确接入执行；资源在正确阶段访问；执行逻辑与预期渲染 Pass 行为一致；渲染函数用到的每个 PassData 字段都在当前录制的 Pass 设置中被显式赋值；不依赖默认值或之前赋值的 PassData 状态；PassData 中存储的资源句柄在当前帧/Pass 录制时重新赋值，不能残留上次使用的悬空句柄。
8. 执行结构问题判定：渲染函数不是 static；API 模式期望静态渲染函数却用实例方法；通过实例状态而非传给静态函数的 PassData/context 访问 PassData 或所需资源；执行流不匹配预期 Render Graph 或 Pass 执行模式；渲染函数读取的 PassData 字段在 Pass 设置中未清晰赋值；只重新赋值部分 PassData 字段而其他字段可能保留对象池复用的陈旧值；PassData 中资源句柄可能因赋值不完整而残留上一帧或上一 Pass 的值；因 PassData 未每次完整初始化而可能使用悬空或陈旧句柄。
9. 执行结构推荐：每次 RecordRenderGraph(...) 调用时显式赋值 Pass 用到的每个 PassData 字段；把 PassData 当作每次录制的临时数据而非持久状态；避免对池化 PassData 对象做部分初始化。
10. Render Graph 描述符验证：默认不要新建 TextureDesc，能直接用图派生的描述符就用；当纹理应匹配当前渲染目标时，先从相关 Render Graph 资源获取描述符，例如 resourceData.activeColorTexture.GetDescriptor(renderGraph) 或其他合适的已有图资源；获取描述符后只修改真正需要不同的字段；name、depth bits、format、MSAA 等字段要有意保留或有意覆盖；任何手动重建描述符数据都要有具体需求支撑。
11. 描述符问题判定：未先尝试复用图派生描述符就新建 TextureDesc；默认手动把宽高复制进新描述符结构；在有更准确的图派生描述符时仍以 cameraTargetDescriptor 为主要来源；意外丢失 MSAA、图形格式或与当前渲染目标的兼容性等重要属性；把描述符重建当作便利捷径而非对源资源的必要偏离。
12. 描述符首选规则：除非图派生描述符无法直接使用或纹理必须有意偏离源资源，否则不要新建 TextureDesc。首选模式：1) 从相关 Render Graph 资源获取描述符；2) 只修改必须改变的字段；3) 尽可能用该派生描述符创建纹理。示例：RenderTextureDescriptor desc = resourceData.activeColorTexture.GetDescriptor(renderGraph); desc.depthBufferBits = 0; desc.name = "New name"; passData.targetTexture = renderGraph.CreateTexture(desc);
13. 手动拷贝 Pass 简化检查：简单纹理拷贝不要用完整自定义光栅 Pass 实现，内置 Render Graph helper 足够时应使用；只读一个纹理并原样写入另一目标的 Pass 应适当简化；优先使用适合目标 API/平台上下文的内置 helper；在当前环境应优先更兼容的 AddBlitPass(...) 重载时，不要默认推荐 AddCopyPass(...)。
14. 拷贝 Pass 问题判定：光栅 Pass 仅用于把一个纹理拷贝到另一个；Pass 不使用材质也无自定义处理；渲染函数只做简单 blit/copy 等价操作；本可用内置 copy/blit helper 更直接表达却用完整自定义光栅 Pass。
15. 拷贝 Pass 推荐：对直接拷贝类操作，当 AddBlitPass(...) 是推荐且更兼容的路径时使用合适的重载；仅当对目标 API/平台明确合适且支持时才用 AddCopyPass(...)；仅当拷贝需要额外逻辑或非平凡行为时才用自定义光栅 Pass。
16. 手动 Blit Pass 简化检查：直接的全屏材质 blit 不要用自定义光栅 Pass 实现，renderGraph.AddBlitPass(...) 能更直接表达相同行为时应使用；仅当确实需要额外逻辑或非平凡行为时才用自定义光栅 Pass；简单源到目标的材质 blit 使用最直接的 Render Graph helper。
17. Blit Pass 问题判定：光栅 Pass 读一个源纹理写一个目标纹理；Pass 使用材质但无额外自定义 Pass 逻辑；渲染函数只做简单全屏 blit；renderGraph.AddBlitPass(...) 能更清晰给出等价结果。
18. Blit Pass 推荐：直接的全屏材质 blit 用 renderGraph.AddBlitPass(...)；仅当确实需要额外逻辑、多操作、条件行为或特殊设置时才用自定义光栅 Pass。
19. 全局资源暴露检查：除非明确要求或下游消费者清晰需要，不要把纹理和缓冲区全局暴露；Render Graph Pass 中需要全局暴露时使用合适的 Render Graph 发布机制；不要用直接修改 command buffer 全局状态替代 Render Graph 资源发布；全局暴露不应不必要地延长资源生命周期或减少别名机会。
20. 全局暴露问题判定：无清晰消费者却用 SetGlobalTextureAfterPass；在 Render Graph Pass 内用 context.cmd.SetGlobalTexture(...) 而 Render Graph 资源发布才是合适机制；把全局暴露当作便利捷径而非显式 Pass 间接线；不必要地引入隐藏耦合；因下游 UseGlobalTexture(...) 或 UseAllGlobalTextures() 使用而使全局暴露纹理存活过久，增加内存压力或减少别名机会。
21. 全局暴露推荐：默认不做全局暴露；尽可能显式资源接线；仅当 Render Graph 中确实需要全局发布时才用 builder.SetGlobalTextureAfterPass(...)；资源生命周期尽量保持局部和短暂。
22. RendererFeature 输入声明检查：ScriptableRendererFeature 及其 Pass 在需要时用 ConfigureInput(...) 声明所需管线输入；请求的输入标志匹配特性预期行为和可见资源使用；目标 API 模式要求时，不要依赖管线提供的输入却不声明；默认不声明不必要的输入请求，尤其可能引入额外拷贝、中间资源或可避免管线工作时。
23. 输入声明问题判定：Pass 使用或明显打算使用管线提供的输入却未用 ConfigureInput(...) 声明；ConfigureInput(...) 请求了特性/Pass 似乎不使用的输入；声明的输入标志与预期效果行为不匹配；效果描述、代码和声明输入暗示冲突需求；不必要的声明输入可能强制额外拷贝、额外 Pass 工作或其他可避免性能成本。
24. 输入声明分类指导：代码清晰显示使用了必需输入却未声明时标记为已确认问题；预期效果暗示需要输入但可见代码未完全证明 shader/资源使用时标记为可能问题；不必要输入声明若可能引入额外拷贝或其他可测量运行时成本，视为更高严重性。
25. 遵守护栏：不发明不支持的 API；区分已确认问题与可能问题；优先最小针对性修复而非大范围重写；解释每个问题为何重要；标记隐藏耦合和不必要的全局状态；当提供的代码不足以完全确定时明确说明。
26. 明确非目标：不保证运行时正确性；除非必要不重写整个 RendererFeature；不验证无关游戏逻辑；除非与 Pass 接线或绑定直接相关，不验证 shader 内部。
27. 成功验证标准：捕获真实接线和 API 问题；识别可疑但看似合理的错误；提供可操作修复；避免虚假确定性；提升对生成渲染 Pass 代码的信任。
28. 未来可扩展的检查项：Pass 顺序/注入点验证、资源生命周期与清理检查、读/写冒险检测、不必要的拷贝或分配、相机深度/颜色依赖验证、多 Pass 依赖验证、override material 正确性、Pass 配置。

适用边界 · 注意事项

• 不适用于验证与 Pass 接线或绑定无关的 shader 内部实现。
• 不适用于验证无关的游戏玩法逻辑。
• 不能保证运行时正确性，也不能替代实际运行测试。