1. 项目概述为什么我们需要Shader Stripper如果你在Unity项目里摸爬滚打了一段时间尤其是在移动端或者对包体大小有严格要求的平台那你大概率经历过这个场景项目越做越大打包出来的APK或者IPA文件体积像吹气球一样膨胀。你打开Profiler切到Memory模块发现ShaderLab占用的内存大得惊人里面塞满了你根本没用过的着色器变体。你可能会疑惑我明明只用了Standard Shader的几个简单材质为什么Unity会打包进来这么多东西这就是我们今天要深入探讨的“Unity Shader Stripper”一个能帮你从根源上“瘦身”着色器资源的利器。简单来说Unity Shader Stripper是一个在项目构建Build时运行的底层工具。它的核心任务就是在最终的游戏包生成之前像一个严格的“审查官”一样遍历项目中所有用到的着色器分析你的项目实际需要哪些着色器变体然后把那些确定用不到的、冗余的变体统统剔除掉。这个过程是自动的但它的行为可以被我们深度定制。对于移动端项目这通常意味着包体大小能减少几兆到几十兆运行时内存占用也能得到显著优化。对于使用URP/HDRP这类自带大量复杂变体的现代渲染管线的项目其收益更是不可估量。2. Shader Stripper的核心原理与工作机制要玩转Shader Stripper你得先理解它在Unity构建流水线中的位置以及它到底在“剪”什么。这能帮你避免很多“一刀切”的误操作。2.1 构建流水线中的关键一环Unity的构建过程远比点击“Build”按钮复杂。在将你的场景、资源、代码编译并打包成最终应用的过程中有一个专门的阶段叫做“Shader Stripping”或“Shader Variant Stripping”。它发生在所有资源被收集、但尚未被最终序列化到AssetBundle或应用包之前。此时Unity已经完成了场景的烘焙、脚本的编译并且通过依赖分析知道了一个“理论上”会被用到的着色器变体集合。Shader Stripper的工作就是对这个理论集合进行二次筛选。2.2 理解着色器变体Shader Variant这是理解所有优化的基石。一个Unity的Shader文件比如一个.shader文件并不是一个最终在GPU上运行的程序。它是一个“着色器源码模板”里面包含了大量的编译指令比如#pragma multi_compile和#pragma shader_feature。举个例子一个材质可能定义了_NORMALMAP关键字表示它使用了法线贴图。而Shader源码中可能有这样的代码#pragma multi_compile __ _NORMALMAP ... #ifdef _NORMALMAP // 采样法线贴图的代码 #else // 使用顶点法线的代码 #endif在构建时Unity会根据项目中所有材质对关键字的启用情况为这个Shader生成多个不同的“变体”。一个变体就是一组特定关键字组合下的、完全编译好的GPU机器码。_NORMALMAP开启是一个变体关闭是另一个变体。如果你的项目有10个这样的布尔型关键字理论上最多可以产生2^101024个变体。现实中的复杂Shader如URP的Lit Shader可能有数十个关键字其变体数量是天文数字。2.3 Stripper的决策逻辑依赖分析与关键字剔除Shader Stripper的决策基于一个核心原则如果一个着色器变体所依赖的所有关键字在整个项目中没有被任何材质、任何Shader全局启用Global Keywords或逐材质启用Local Keywords所引用那么这个变体就是可以被安全剔除的。它的工作流程可以简化为收集阶段遍历所有场景、预制体、Resources文件夹、以及通过代码动态加载的资源收集所有材质Material上设置的关键字。分析阶段结合项目的Graphics Settings如图形API层级、渲染管线设置和Player Settings如是否启用雾效、阴影形成一个“项目实际使用的关键字集合”。剔除阶段遍历所有需要被打包的Shader检查其每一个可能的变体。如果该变体所需的任意一个关键字不在上一步的“实际使用集合”中则该变体被标记为剔除。序列化阶段只有未被剔除的变体其编译后的字节码和相关信息才会被写入最终的构建包。注意这里有一个非常重要的细节。#pragma shader_feature和#pragma multi_compile在Stripping行为上有本质区别。shader_feature生成的变体只有在项目中至少有一个材质显式启用了该关键字时该变体才会被打包。而multi_compile生成的变体默认是全部打包的除非你能向Stripper证明某个关键字完全没用。理解这一点是进行高级优化的关键。3. 基础配置与可视化检查在开始编写复杂的自定义Stripping代码之前我们先通过Unity编辑器自带的工具来直观地感受和理解当前项目的Shader变体情况。3.1 使用Shader Variant Collection进行预收集这是最直接、最有效的基础优化手段。Unity允许你创建一个“着色器变体集合”Shader Variant Collection SVC资产。你可以把它想象成一个“白名单”。操作步骤在Project窗口中右键 - Create - Shader - Shader Variant Collection。选中新建的SVC资产在Inspector窗口中你可以通过点击“Add Shader”添加项目中的着色器。对于每个着色器你可以点击“Add Variant”然后通过勾选不同的关键字组合来手动添加你确定需要的变体。将这个SVC资产拖拽到Project Settings - Graphics - Shader Stripping - Preloaded Shaders列表中。它的作用是什么被添加到“Preloaded Shaders”列表中的SVC会告诉Unity构建系统“不管项目其他地方用不用这个集合里的所有变体都必须无条件保留并打包。” 这对于确保通过Resources.Load或AssetBundle动态加载的材质能正确显示至关重要因为静态依赖分析可能无法追踪到这些运行时逻辑。实操心得一个高效的实践是为你的项目核心、通用的Shader如UI Shader、角色通用Shader创建一个SVC并包含它们最常用的几个变体如无光照、加雾效、加软阴影。这能保证这些基础功能在任何加载路径下都万无一失。3.2 解读构建日志中的Shader信息Unity构建完成后在Console窗口选择“Editor Log”或者打开构建路径下的BuildLog.json文件搜索“Shader stripping”或“Variants”你能找到类似下面的关键信息Shader ‘MyCustomShader’ – 总共 256 个变体已剔除 180 个保留 76 个。 Shader ‘Universal Render Pipeline/Lit’ – 总共 32468 个变体已剔除 31240 个保留 1228 个。这些数据非常直观。如果某个Shader的“保留”数量依然巨大比如上面URP Lit的1228个就意味着还有很大的优化空间。你需要思考你的项目真的需要这1228种不同的Lit表现组合吗3.3 图形设置与Player Settings的影响很多全局设置会隐式地启用或禁用一系列Shader关键字从而影响Stripping结果。Project Settings - Graphics:Shader Stripping 模块除了Preloaded Shaders这里还有“Fog Stripping”、“Instancing Variants Stripping”等选项。例如如果你确定项目在任何平台都不使用雾效那么关闭“Fog Stripping”选项Unity就会剔除所有与雾效相关的Shader变体效果立竿见影。Render Pipeline Asset (URP/HDRP)你使用的URP/HDRP资源文件中的设置如是否启用DBuffer Decals、是否使用高质量采样等会直接决定一大批内置Shader关键字的开关。Project Settings - Player - Other Settings:Color Space使用Linear还是Gamma会影响着色器中的颜色计算变体。Auto Graphics API如果移除了不用的图形API比如在iOS上移除OpenGL ES那么为该API编译的Shader变体也会被剔除。注意事项在调整这些全局设置时务必进行全面的功能测试。特别是跨平台项目某个设置在PC上关闭了但可能在某个移动端特性中还需要。4. 高级定制编写自定义Shader Stripper脚本当可视化配置和全局设置无法满足精准剔除的需求时我们就需要祭出终极武器通过C#脚本编写自定义的Shader Stripper。这允许你以编程方式干预剔除过程实现像素级控制。4.1 创建与注册Stripper类Unity提供了一个名为IPreprocessShaders的接口。任何实现了该接口的类只要放在Editor文件夹下就会被Unity构建管线自动识别和调用。创建一个脚本例如CustomShaderStripper.cs放在Assets/Editor/目录下。using UnityEditor.Build; using UnityEditor.Rendering; using UnityEngine; using UnityEngine.Rendering; using System.Collections.Generic; // 实现 IPreprocessShaders 接口。CallbackOrder属性决定执行顺序如果有多个Stripper。 public class CustomShaderStripper : IPreprocessShaders { // 执行顺序数字越小越先执行。一般保持默认即可。 public int callbackOrder { get { return 0; } } // 核心回调方法。每个Shader的每个变体在决定去留时都会调用此方法。 public void OnProcessShader( Shader shader, ShaderSnippetData snippet, IListShaderCompilerData data) { // shader: 当前正在处理的着色器对象。 // snippet: 着色器代码片段信息如Pass Type, Pass Name。 // data: 一个ShaderCompilerData列表每个元素代表一个待处理的着色器变体。 // 我们的任务就是遍历这个data列表把不需要的变体从中移除。 } }4.2 实现精准剔除逻辑在OnProcessShader方法内部你可以编写复杂的逻辑来判断每个变体。ShaderCompilerData结构体包含了该变体的所有信息其中最关键的是shaderKeywordSet它封装了这个变体所启用的所有关键字。一个常见的策略是“黑名单”或“白名单”。示例1剔除特定Shader的特定Pass中的特定变体假设我们项目中有一个复杂的特效Shader “Custom/ComplexEffect”它有一个用于屏幕扭曲的PassPass Name: “Distortion”。我们通过分析发现这个Pass下所有启用了_USE_REFRACTION折射关键字的变体在当前的手机项目里性能开销太大决定全部禁用。public void OnProcessShader(Shader shader, ShaderSnippetData snippet, IListShaderCompilerData data) { // 只处理名为“Custom/ComplexEffect”的Shader if (shader.name ! Custom/ComplexEffect) return; // 只处理Pass Name为“Distortion”的片段 if (snippet.passName ! Distortion) return; // 从后向前遍历列表安全移除元素 for (int i data.Count - 1; i 0; i--) { var compilerData data[i]; // 检查该变体的关键字集中是否包含 _USE_REFRACTION if (compilerData.shaderKeywordSet.IsEnabled(new ShaderKeyword(_USE_REFRACTION))) { // 从列表中移除这个变体 data.RemoveAt(i); // 可以在这里记录日志便于调试 // Debug.Log($Stripped variant with _USE_REFRACTION from {shader.name}.{snippet.passName}); } } }示例2基于项目配置的批量剔除假设我们为高端PC和低端手机准备了两个图形质量等级。在打移动端包时我们想剔除所有与“级联阴影”Cascaded Shadows和“屏幕空间反射”SSR相关的高开销变体。public void OnProcessShader(Shader shader, ShaderSnippetData snippet, IListShaderCompilerData data) { // 只在打Android/iOS包时执行此剔除逻辑 #if UNITY_IOS || UNITY_ANDROID ListShaderKeyword keywordsToStrip new ListShaderKeyword(); // 初始化要剔除的关键字列表 keywordsToStrip.Add(new ShaderKeyword(_MAIN_LIGHT_SHADOWS_CASCADE)); // 级联阴影 keywordsToStrip.Add(new ShaderKeyword(_SCREEN_SPACE_OCCLUSION)); // SSAO (假设移动端不用) // 注意URP中SSR可能有其他关键字需要根据实际Shader源码确定 for (int i data.Count - 1; i 0; i--) { var compilerData data[i]; foreach (var keyword in keywordsToStrip) { if (compilerData.shaderKeywordSet.IsEnabled(keyword)) { data.RemoveAt(i); break; // 该变体已移除检查下一个变体 } } } #endif }4.3 调试与验证你的Stripper自定义Stripper的调试需要一些技巧因为它在构建Build时运行而非播放模式。使用Debug.Log在OnProcessShader中 strategically地添加日志输出。构建时这些日志会出现在Editor Log或BuildLog.json中。注意不要在每个变体上都打印否则日志会爆炸。可以只记录被剔除的变体总数或特定Shader的信息。对比构建报告最可靠的方法是进行A/B测试。进行一次正常的构建记录关键Shader的保留变体数从构建日志看。启用你的自定义Stripper脚本再次构建。对比两次构建的日志确认目标Shader的变体数是否如预期减少。最终必须进行实机运行测试遍历所有场景和特效确保没有出现材质变粉红Missing Shader的情况。利用ShaderUtil.GetShaderVariantCount仅限Editor你可以在Editor脚本中调用此API来获取某个Shader当前的变体总数辅助分析。避坑技巧在编写剔除逻辑时务必格外小心#pragma multi_compile_fog、#pragma multi_compile_instancing这类由Unity渲染管线内部管理的关键字。错误地剔除它们可能导致物体渲染异常。最佳实践是初期只剔除你100%确定由自己定义且不再使用的功能关键字。5. 针对URP/HDRP的专项优化策略现代可编程渲染管线SRP如URP和HDRP其内置着色器体系非常复杂关键字数量庞大是Shader Stripping优化的主战场。5.1 理解URP的内置关键字体系URP的着色器如Lit、SimpleLit、Unlit使用一套高度模块化的关键字系统。例如_NORMALMAP、_SPECULAR_SETUP、_RECEIVE_SHADOWS_OFF等。你可以通过查看URP的Shader源码通常位于Packages/com.unity.render-pipelines.universal/Shaders/来了解完整的关键字列表。URP管线的设置URP Asset是控制这些关键字的核心主光源阴影如果关闭了“Main Light Shadows”那么所有与之相关的阴影采样变体都可以被剔除。附加光照如果“Additional Lights”设置为“Off”那么所有逐像素的附加光照计算变体都可以被剔除。渲染器特性URP Asset中启用的Renderer Features如Render Objects、Screen Space Ambient Occlusion会引入新的Shader变体。禁用不用的Renderer Feature是减少变体的直接方法。5.2 剥离未使用的渲染器特性与光照模式这是优化URP项目最有效的一步。你需要像审计员一样检查项目审计所有材质检查场景中和资源目录下的材质是否使用了“Universal Render Pipeline/Lit”等复杂着色器但实际只用了最基础的功能例如只是一个纯色无贴图的材质。对于这些材质可以将其Shader切换为更轻量的“Universal Render Pipeline/Unlit”或“Universal Render Pipeline/Simple Lit”这能直接避免Lit Shader的大量复杂变体。审计URP Asset配置确认你的目标平台如低端安卓机对应的URP Asset是否关闭了所有非必需的高质量特性如将“Shadow Cascades”设置为“No Cascades”。将“Additional Lights”设置为“Per Vertex”或“Off”。关闭“Depth Texture”和“Opaque Texture”如果后处理不需要。编写针对URP Shader的Stripper你可以编写一个专门的Stripper针对URP内置Shader进行批量操作。例如强制为移动端剔除Lit Shader中所有与“Clear Coat”清漆层、“Anisotropy”各向异性等高级材质模型相关的变体因为这些特性在移动端极少使用且开销大。// 示例为移动端剔除URP Lit中与各向异性相关的高级变体 private static readonly ShaderKeyword k_KeywordAnisotropy new ShaderKeyword(_ANISOTROPY); private static readonly ShaderKeyword k_KeywordClearCoat new ShaderKeyword(_CLEARCOAT); public void OnProcessShader(Shader shader, ShaderSnippetData snippet, IListShaderCompilerData data) { #if UNITY_IOS || UNITY_ANDROID // 只处理URP的核心Lit Shader if (!shader.name.Contains(Universal Render Pipeline/Lit)) return; for (int i data.Count - 1; i 0; i--) { var compilerData data[i]; // 如果变体启用了各向异性或清漆层关键字则剔除 if (compilerData.shaderKeywordSet.IsEnabled(k_KeywordAnisotropy) || compilerData.shaderKeywordSet.IsEnabled(k_KeywordClearCoat)) { data.RemoveAt(i); } } #endif }5.3 管理自定义Shader与Shader Graph变体对于你自己编写的Shader或使用Shader Graph创建的Shader优化原则是相同的但需要你对自己的代码有清晰认识。对于手写Shader审阅你的#pragma multi_compile和#pragma shader_feature语句。问自己这个功能所有平台都需要吗能否拆分成两个独立的Shader将multi_compile改为shader_feature可以带来更激进的Stripping因为未使用的shader_feature变体默认不会打包。对于Shader GraphShader Graph的每个布尔开关、枚举下拉菜单在背后都会生成对应的Shader关键字。在Graph的“Graph Inspector”中你可以为每个属性设置“Keyword”。对于移动端专用Graph应果断关闭那些用于高端效果如视差映射、曲面细分的节点分支。在打移动端包时甚至可以创建一份简化版的Shader Graph并在构建设置中替换引用。6. 实战问题排查与效果评估即使配置得当Shader Stripping也可能引入难以察觉的问题。掌握排查方法才能安心使用这项优化。6.1 典型问题与解决方案问题现象可能原因排查与解决思路运行时材质显示粉红色Missing1. 动态加载的材质所需变体被错误剔除。2. 自定义Stripper逻辑过于激进剔除了实际需要的变体。3. Shader Variant Collection (SVC) 配置不全。1. 确认该材质是否通过Resources或AssetBundle加载。如果是确保其Shader的所有可能变体都已加入Preloaded Shaders的SVC中。2. 临时注释掉自定义Stripper脚本重新打包测试。如果问题消失则需细化Stripper的剔除条件。3. 在编辑器播放模式下使用Frame Debugger查看该材质实际使用的Shader Pass和关键字确保SVC覆盖了该组合。特定平台如iOS渲染错误其他平台正常1. 该平台使用了不同的Graphics API而该API相关的变体被错误剔除。2. 针对该平台的Quality Settings或URP Asset配置不同导致关键字集合变化。1. 检查Player Settings中该平台的Graphics APIs列表确保没有误删必要的API如iOS上通常只需Metal。2. 对比问题平台与正常平台的Graphics和Quality设置差异。确保Stripper脚本中使用了正确的平台编译指令如#if UNITY_IOS。包体大小或内存下降不明显1. 优化未触及主要的变体“大户”。2. 项目本身使用的Shader和材质已经非常精简。3. 大量变体来自#pragma multi_compile而项目实际使用了其中大部分关键字。1. 分析构建日志找到保留变体数量最多的几个Shader通常是URP/HDRP内置Shader或第三方复杂Shader针对它们进行优化。2. 检查是否已关闭Graphics Settings中所有不必要的特性如雾效、级联阴影。3. 考虑将关键Shader中的multi_compile重构为shader_feature或拆分Shader。编辑器下预览正常打包后出错编辑器模式不会执行完整的Stripping流程。这是Stripping问题的典型特征。必须通过打包并真机/真平台测试来验证。在构建开发包Development Build并启用“Autoconnect Profiler”后通过Profiler连接真机查看Shader加载情况。6.2 量化优化效果优化不能凭感觉需要有数据支撑。包体大小Build Size最直接的指标。对比优化前后APK/IPA文件的大小。注意由于压缩等因素Shader变体减少对包体的影响可能不是线性的但通常会有明显下降。构建日志分析如前所述构建日志中每个Shader的“已剔除/保留”变体数是核心指标。可以制作一个简单的脚本解析BuildLog.json汇总所有Shader的变体总数变化。运行时内存Runtime Memory使用ProfilerDeep Profiling或Memory Profiler抓取游戏运行时的内存快照。重点观察“ShaderLab”所占用的内存。一个成功的Stripping优化应该能看到这部分内存的显著降低。这对于移动端避免内存峰值导致的闪退至关重要。构建时间Build TimeShader变体越多编译时间越长。优化后你可能会观察到项目构建速度有所提升尤其是Clean Build。6.3 建立可持续的优化流程Shader Stripping不是一劳永逸的设置而应成为项目研发流程的一部分。版本控制将你自定义的CustomShaderStripper.cs脚本和重要的ShaderVariantCollection.asset文件纳入版本管理。CI/CD集成在自动化构建服务器上可以在构建完成后自动分析构建日志提取关键Shader的变体数量并与基线进行对比。如果发现某个版本变体数量异常增长可以触发警报。团队规范建立美术和特效制作规范。例如规定移动端项目禁止使用某些会产生高开销变体的Shader特性如折射、各向异性。新制作的材质应优先使用Unlit或SimpleLit着色器。定期审计在每个大的里程碑如Alpha、Beta版本前重新进行一遍Shader变体审计。检查是否有新的第三方插件引入了新的、未优化的Shader或者项目需求变更后之前被剔除的特性现在又需要了。Shader Stripping是一项从“浪费”中榨取性能的精细技术。它要求开发者对项目的渲染需求有深刻的理解对Unity的构建机制有清晰的把握。开始时可能会觉得繁琐但一旦建立起有效的配置和流程它就能持续为你的项目带来可观的包体和内存收益尤其是在面向硬件资源受限的移动平台时这份收益往往是决定产品能否顺利上线和留存的关键因素之一。我的经验是将其作为项目性能优化的标准环节在开发中期就介入并持续维护远比在项目尾声时手忙脚乱地补救要高效和稳定得多。