图形渲染与 Shader / 系统课时
Shader Variant 为什么会越编越大
Shader Variant 为什么会越编越大
Shader Variant 不是“一个 Shader 的几个名字”,而是同一份 Shader 在不同关键字组合下生成的不同编译结果。问题在于多组关键字会做笛卡尔积:每增加一组选项,都可能把已有变体整体再复制一遍,最终拖长导入与构建时间,并增加包体、内存和运行时预热压力。
学习目标
- 理解关键字选项如何乘法式扩大 Variant 数量
- 区分
shader_feature与multi_compile的常见使用目的 - 能从关键字设计上减少不必要的组合爆炸
变体数量为什么是乘出来的
假设一个 Pass 有两组关键字。第一组是“不启用细节”或“启用细节”,有 2 种选择;第二组是“无阴影、低质量阴影、高质量阴影”,有 3 种选择。理论组合数就是 2 × 3 = 6。如果再增加一个 4 选 1 的效果组,数量会变成 2 × 3 × 4 = 24。

真正项目中的总量还会受到 Pass、目标平台、图形 API、编译阶段和变体剥离影响,所以关键字组合数不等于最终进入包内的数量,但它能最快暴露设计是否已经失控。十个互相独立的二值功能,单看组合就会达到 2^10 = 1024 个理论组合。
关键字声明会怎样产生组合
下面是 ShaderLab 中的片段示例,依赖 HLSLPROGRAM 上下文,重点只展示变体声明,因此不是可独立运行的完整 Shader。
#pragma shader_feature_local _ USE_DETAIL
#pragma multi_compile _ SHADOW_LOW SHADOW_HIGH第一行有关闭与 USE_DETAIL 两种状态;第二行有 _、SHADOW_LOW、SHADOW_HIGH 三种状态,因此两组组合后理论上得到 6 个变体。shader_feature 更适合由材质实际使用情况驱动的可选功能,构建时未被需要的组合可以被剥离;multi_compile 更适合必须覆盖多种运行时状态的场景,会产生更完整的候选组合。最终保留数量仍取决于项目剥离规则和目标平台。
可以用一个最小程序先估算纯组合规模,避免增加关键字时只凭感觉判断。
using System;
public static class Program
{
public static void Main()
{
int[] optionCounts = { 2, 3, 4 };
long variants = 1;
foreach (int count in optionCounts)
{
variants *= count;
}
Console.WriteLine($"Theoretical variants: {variants}");
}
}预期输出
Theoretical variants: 24这个结果只表示三组关键字的理论笛卡尔积,不包含多个 Pass、不同平台编译以及构建剥离带来的数量变化。
组合爆炸会带来什么代价
构建阶段首先承受的是编译与缓存压力:更多变体意味着更多编译任务和中间产物。若大量组合最终没有被使用,仍可能消耗导入、构建和 CI 时间。包体是否明显增加取决于剥离效果和目标平台,但“先制造大量候选组合,再完全依赖剥离救场”通常会让构建过程越来越难控制。
运行时更关心真正进入构建并被加载的变体。数量过多会增加 Shader 数据和相关资源占用,也可能扩大预热集合;某些未提前准备的组合第一次被使用时,还可能出现管线创建或着色器准备造成的卡顿。具体行为随引擎版本和图形后端变化,但减少实际可达组合始终有助于控制成本。
从关键字设计上减小规模
先确认一个功能是否真的需要关键字。如果差异只是少量计算,而且动态分支成本可以接受,可以考虑统一代码路径,而不是额外制造编译变体。其次,把互斥选项组织成同一组选项,而不是多个独立布尔关键字;两个实际上不能同时开启的功能若被写成两个布尔开关,就会额外生成没有业务意义的组合。
还要区分材质级功能和必须动态覆盖的环境状态。仅由单个材质决定的可选功能可以优先考虑 shader_feature_local;确实需要覆盖全部运行时状态时再使用 multi_compile。其中 local 主要限制关键字作用域,本身不会自动减少笛卡尔积,因此不能把它当作变体数量优化开关。
判断是否需要继续拆分
当一个 Pass 同时承担大量互不相关的功能时,关键字往往会不断追加。此时应检查能否把差异明显的材质类别拆成独立 Shader,或把只在少数对象使用的高成本功能移出主路径。目标不是追求“零 Variant”,而是让留下的组合对应真实可达的渲染需求,避免为永远不会出现的状态支付编译和运行成本。