1. 项目概述为什么你需要理解Shader结构如果你在Unity里做过一段时间的项目尤其是涉及到一些稍微复杂的视觉效果时大概率已经和Shader打过交道了。你可能用过一些现成的Shader比如Standard、URP/Lit或者从Asset Store下载过一些炫酷的水、火、卡通渲染效果。但当你想要修改一个效果或者想从零开始实现一个特定的视觉风格比如最近很火的水墨风格或者体积光效果时往往会发现无从下手。对着一个.shader文件里面密密麻麻的代码和语法感觉像在看天书。这正是因为你不了解Shader的“结构”。Shader不是一段可以随意堆砌的魔法代码它是一份有着严格格式和逻辑的“说明书”告诉GPU如何一步步地处理模型的每一个顶点和像素。理解这份说明书的结构就像拿到了一个复杂仪器的电路图你才能知道哪里是电源、哪里是信号处理单元、哪里可以接入你自己的模块。无论是想用Shader Graph可视化连线还是手写ShaderLab代码亦或是排查那些令人头疼的“Missing Global Shader”错误底层结构的知识都是你绕不开的基石。今天我们就来彻底拆解Unity Shader的结构。我不会只停留在表面语法而是会结合我这些年踩过的坑和项目经验告诉你每个部分存在的意义、常见的写法、以及那些官方文档里不会写的“潜规则”。目标是让你看完之后能自信地打开任何一个.shader文件快速定位到关键部分并知道如何动手修改它。2. Shader结构全景与核心设计思想在深入代码之前我们必须先建立对Unity Shader的宏观认知。很多人包括早期的我都容易混淆几个概念Shader程序、Shader对象、Material、Shader Asset。厘清这些是理解结构的第一步。Shader程序这是最核心的概念指的是运行在GPU上的那一小段程序。它直接操作顶点和像素数据。在传统图形学中我们主要接触顶点着色器和片元着色器。顶点着色器处理模型的每个顶点位置片元着色器或称像素着色器决定屏幕上每个像素的最终颜色。这是Shader的“灵魂”。Shader对象这是Unity封装的一个C#类Shader类的实例。它是Shader程序在Unity引擎中的“容器”或“管理器”。一个Shader对象内部可能包含多个变体——即针对不同渲染管线Built-in、URP、HDRP、不同渲染状态是否有阴影、是否启用雾效或不同关键字如_NORMALMAP是否开启而编译的多个版本的Shader程序。当你创建一个Material并为其指定一个Shader时你关联的就是这个Shader对象。Material材质球。它是Shader对象的参数实例。Shader定义了需要哪些参数颜色、纹理、浮点数而Material则保存了这些参数的具体值。一个Shader对象可以被无数个Material共用每个Material可以有不同的参数值从而表现出不同的外观。Shader Asset就是你项目Assets文件夹里的那个.shader文件。它定义了如何创建和配置一个Shader对象。我们接下来要详解的“结构”指的就是这个.shader文件的内容结构。Unity设计ShaderLab语言的初衷是为了用一套相对友好、声明式的语法来管理上述这些复杂的关系。它让你在一个文件里不仅能编写GPU代码HLSL/Cg还能定义属性列表、配置渲染状态、管理多个SubShader和Pass以适应不同硬件或渲染路径。这种“一站式”的设计思想是Unity Shader结构的核心。注意很多人会问Shader Graph生成的Shader和手写的有什么区别本质上没有区别。Shader Graph是一个可视化编辑器它最终也会生成一个符合ShaderLab语法的.shader文件。理解手写结构能让你更深入地调试和优化Shader Graph生成的结果甚至在必要时直接修改生成的代码。3. Shader文件结构逐层详解一个标准的Unity Shader文件就像一棵树从根部到枝叶有清晰的层次。我们从最外层的结构开始讲起。3.1 第一层Shader根块与属性块每个.shader文件都以Shader关键字开头后面跟着一个用引号括起来的路径字符串。这个字符串决定了Shader在Material的Shader下拉菜单中的位置。Shader “MyCustom/ExampleShader” { // 整个Shader的内容都包含在这个大括号内 }路径可以自定义如“Unlit/MyTexture”或“Custom/Toon”这是一种组织分类的好习惯。紧接着Shader声明之后的通常是Properties块。这是Shader的“参数面板”定义了哪些参数可以暴露给Material Inspector材质面板进行编辑。Properties { // 属性语法_变量名 (“显示名”, 类型) 默认值 _MainTex (“Albedo (RGB)”, 2D) “white” {} _Color (“Tint Color”, Color) (1,1,1,1) _Glossiness (“Smoothness”, Range(0,1)) 0.5 _Metallic (“Metallic”, Range(0,1)) 0.0 [Toggle] _UseNormalMap (“Use Normal Map?”, Float) 0 }关键点解析变量名以_开头在后续的CG/HLSL代码中需要通过相同的名字来引用。这是连接属性面板和GPU代码的桥梁。显示名显示在材质面板上的友好名称可以包含空格。类型常见的有2D一张纹理默认值通常为“white” {},“black” {},“bump” {}灰色法线或“gray” {}。Color/Vector颜色或四维向量。Range(min, max)一个滑块控制的浮点数。Float/Int直接输入的数值。Cube立方体贴图用于反射。属性特性像[Toggle]、[Enum(Off,0, On,1)]、[HDR]这样的方括号标签用于修饰属性改变其在面板上的UI表现或附加一些元数据。例如[HDR]会让颜色选择器支持高动态范围值。实操心得属性名最好保持描述性且一致。例如主纹理用_MainTex主颜色用_MainColor或_Color这是社区约定俗成的习惯便于他人阅读和工具识别。另外Properties块中定义的属性并不会自动传递到GPU。它只是在材质面板上创建了一个编辑接口。你必须在后续的CGPROGRAM代码中用相同的名字再次声明一个变量才能真正在着色器程序中使用它。3.2 第二层SubShader——适配不同配置的核心一个Shader对象可以包含多个SubShader。这是Unity Shader结构中最关键的设计之一用于实现跨平台和降级支持。SubShader { // 适用于高端平台如PC、主流主机的渲染配置和代码 Tags { “RenderType”“Opaque” “Queue”“Geometry” } LOD 200 // ... Passes 定义在这里 } SubShader { // 适用于低端平台如老移动设备的简化版本 Tags { “RenderType”“Opaque” “Queue”“Geometry” } LOD 100 // ... 更简单、更少的 Passes 定义在这里 }工作原理Unity在运行时会从第一个SubShader开始检查。它会评估当前运行平台的显卡能力、渲染管线设置等看是否满足该SubShader所声明的需求通过Tags和LOD等。如果满足就使用这个SubShader如果不满足则继续检查下一个SubShader。最后一个SubShader通常是一个极其简单的、保证能在任何设备上运行的“保底”方案例如一个纯色Shader。Tags子着色器标签。这是键值对集合用于告诉Unity如何以及何时渲染这个SubShader。“RenderType”非常重要的标签用于替换着色器如摄像机深度纹理、后期处理和着色器分类。常见值有“Opaque”不透明、“Transparent”透明、“TransparentCutout”镂空等。“Queue”定义渲染顺序。“Geometry”默认不透明物体“Transparent”透明物体从后往前渲染“AlphaTest”镂空物体“Overlay”叠加层如UI。你也可以指定数字如“Queue”“Geometry1”。“ForceNoShadowCasting”“True”/“False”是否强制不投射阴影。“IgnoreProjector”“True”忽略投影器Projector组件常用于透明物体。LOD细节级别。这是一个数字。你可以通过Shader.globalMaximumLOD或Material.shader.maximumLOD在代码中动态控制。当设置的LOD值小于SubShader的LOD时该SubShader将被跳过。这是一种在运行时根据设备性能动态切换Shader复杂度的机制。为什么需要多个SubShader想象一下你的游戏要同时发布在PC和低端安卓手机上。PC版你可以使用包含PBR、法线、视差等复杂计算的高质量Shader。而在手机上你可以提供一个只做漫反射和简单高光的简化SubShader。通过设置不同的LOD值游戏可以根据设备性能自动选择或者你可以在选项菜单中让玩家手动选择“画质等级”来切换。3.3 第三层Pass——渲染的基本单元Pass渲染通道是SubShader内部的构建块也是实际绘制调用发生的地方。一个SubShader可以包含一个或多个Pass。每个Pass代表一次完整的几何体渲染流程。Pass { Name “FORWARD” // 可选的Pass名称用于其他Shader通过UsePass引用 Tags { “LightMode” “ForwardBase” } // 至关重要的标签定义Pass的用途 // 渲染状态设置混合、深度测试、剔除等 ZWrite On ZTest LEqual Cull Back Blend SrcAlpha OneMinusSrcAlpha CGPROGRAM // HLSL/Cg代码开始 #pragma vertex vert #pragma fragment frag // ... 着色器程序代码 ENDCG }Pass的核心组件LightMode Tag这是Pass的“灵魂”。它告诉Unity这个Pass在渲染管线中扮演什么角色。不同的渲染路径前向渲染、延迟渲染会寻找具有特定LightMode的Pass来执行相应任务。“ForwardBase”前向渲染基础Pass。处理环境光、主平行光和逐顶点/SH光源。“ForwardAdd”前向渲染附加Pass。处理额外的逐像素光源通常混合模式为Blend One One。“ShadowCaster”用于渲染物体到阴影贴图。“DepthOnly”/“DepthNormals”用于生成深度纹理或深度法线纹理常用于屏幕空间效果。“UniversalForward”(URP) /“SRPDefaultUnlit”(URP)URP管线中的对应标签。如果你写一个不参与标准光照计算的Pass如全屏后处理、UI特效可以设为“LightMode” “Always”或直接不写。渲染状态这些命令直接设置GPU的固定功能状态。ZWrite是否写入深度缓冲区。透明物体通常设为Off。ZTest深度测试比较函数。LEqual默认物体在其深度值小于等于缓冲区值时通过、Always总是通过用于UI或全屏效果。Cull背面剔除模式。Back剔除背面默认、Front剔除正面用于内部可见的物体如球体内壁、Off双面渲染性能消耗大。Blend定义颜色混合方式。语法为Blend SrcFactor DstFactor。这是实现透明的关键。SrcAlpha OneMinusSrcAlpha是经典的Alpha混合。Blend One One是加法混合常用于发光、火焰效果。CGPROGRAM/HLSLPROGRAM 代码块这里是编写实际着色器程序的地方。在Unity 2021.2及更早版本或Built-in管线中常用CGPROGRAM。现在更推荐使用HLSLPROGRAM因为它更符合现代HLSL标准。两者在Unity中用法几乎相同。3.4 第四层CG/HLSL代码块——着色器程序的灵魂这是Shader真正“干活”的地方。代码块被包裹在CGPROGRAM和ENDCG或HLSLPROGRAM/ENDHLSL之间。CGPROGRAM // 编译指令 #pragma vertex vert #pragma fragment frag #pragma multi_compile_fog // 多编译变体指令 #pragma shader_feature _NORMALMAP // 着色器特性指令 // 包含文件引入Unity内置函数和变量 #include “UnityCG.cginc” #include “Lighting.cginc” // 如果要做光照计算 // 从Properties块链接变量必须重新声明 sampler2D _MainTex; float4 _MainTex_ST; // 纹理的缩放偏移值命名必须为“纹理名_ST” fixed4 _Color; float _Glossiness; float _Metallic; // 从Unity传入的模型、视图、投影矩阵等 // 通常通过 UnityObjectToClipPos 等内置函数访问无需手动声明。 // 输入结构体从CPU模型数据传递到顶点着色器的数据 struct appdata { float4 vertex : POSITION; // 顶点位置模型空间 float3 normal : NORMAL; // 法线 float2 uv : TEXCOORD0; // 第一套UV }; // 顶点着色器到片元着色器的传递结构体 struct v2f { float2 uv : TEXCOORD0; float4 vertex : SV_POSITION; // 裁剪空间位置必须 UNITY_FOG_COORDS(1) // 内置宏声明雾效插值器 }; // 顶点着色器函数 v2f vert (appdata v) { v2f o; o.vertex UnityObjectToClipPos(v.vertex); // 模型空间-裁剪空间 o.uv TRANSFORM_TEX(v.uv, _MainTex); // 应用纹理的缩放和偏移 UNITY_TRANSFER_FOG(o, o.vertex); // 传递雾效数据 return o; } // 片元着色器函数 fixed4 frag (v2f i) : SV_Target { fixed4 col tex2D(_MainTex, i.uv) * _Color; // 采样纹理并乘颜色 UNITY_APPLY_FOG(i.fogCoord, col); // 应用雾效 return col; } ENDCG代码块关键部分拆解编译指令以#pragma开头。#pragma vertex [函数名]指定顶点着色器函数。#pragma fragment [函数名]指定片元着色器函数。#pragma multi_compile .../#pragma shader_feature ...这是Unity Shader变体系统的核心。它们告诉Unity为不同的关键字组合如_NORMALMAP_ON和_NORMALMAP_OFF编译多个版本的Shader代码。这是Shader文件大小膨胀的主要原因但也是实现功能开关如是否使用法线贴图的必备机制。包含文件#include类似于C语言用于引入Unity预定义的函数、宏和变量。UnityCG.cginc是最基础且必不可少的包含了空间变换、雾效等常用工具。Lighting.cginc包含了前向渲染的光照模型函数。变量声明必须在这里重新声明在Properties中定义并需要在GPU代码中使用的变量。注意_MainTex_ST这个约定对于任何名为_Xxx的纹理你可以通过_Xxx_ST.xy获取其缩放Tiling通过_Xxx_ST.zw获取其偏移Offset。TRANSFORM_TEX宏就是利用这个变量来转换UV的。结构体与语义appdata定义从网格数据中读取哪些信息。POSITION,NORMAL,TEXCOORD0,TANGENT等都是语义它们绑定了模型数据的特定含义。v2f顶点着色器输出、片元着色器输入的结构体。SV_POSITION是系统值语义表示裁剪空间位置必须赋值。TEXCOORD0、TEXCOORD1等用于传递自定义插值数据如UV、法线、视角方向等。语义是连接CPU端数据和GPU着色器程序的桥梁必须正确匹配。着色器函数vert函数对每个顶点执行。主要工作是坐标变换从模型空间到裁剪空间和准备需要插值后传递给片元着色器的数据。frag函数对每个像素更准确说是片元执行。接收插值后的数据进行纹理采样、光照计算等最终返回一个颜色值SV_Target。4. 高级结构与实战技巧掌握了基础结构我们来看看那些让Shader更强大、更高效的高级特性和实战技巧。4.1 Fallback与CustomEditor在所有的SubShader之后你还可以定义两个特殊指令。// 在文件末尾SubShader块之后 Fallback “Diffuse” // 或 Fallback Off CustomEditor “MyCustomShaderGUI”Fallback指定一个“后备”Shader。如果当前Shader的所有SubShader在当前硬件上都不支持Unity就会尝试使用Fallback指定的Shader来渲染。“Diffuse”是Unity内置的一个非常简单的漫反射Shader兼容性极好。设为Off则表示没有后备渲染失败时物体可能显示为洋红色Missing Shader。最佳实践对于重要的自定义Shader总是设置一个简单的Fallback以确保在极端情况下物体可见。CustomEditor允许你为Shader编写一个自定义的材质面板编辑器脚本继承自ShaderGUI。当你的Shader属性非常复杂或者你想根据某个属性的开关动态显示/隐藏其他属性时这就非常有用。例如勾选“启用视差映射”后才显示“视差高度”和“视差采样次数”这两个属性。4.2 多Pass协作与渲染队列一个SubShader内多个Pass的执行顺序是自上而下的。每个Pass都会产生一次Draw Call。因此多Pass Shader对性能的影响是倍增的需谨慎使用。经典的多Pass用例轮廓描边效果第一个Pass用正面剔除Cull Front和简单的顶点外扩来渲染放大的背面作为轮廓。第二个Pass正常渲染模型本身。透明叠加效果例如一个玻璃材质可能需要一个Pass渲染反射一个Pass渲染折射再一个Pass渲染高光。每个Pass使用不同的混合模式。复杂光照模型在Built-in前向渲染中一个ForwardBasePass处理环境光和主平行光后续多个ForwardAddPass每个Pass对应一个额外的逐像素光使用加法混合叠加光照贡献。渲染队列的深度应用“Queue”标签不仅影响顺序还影响渲染类型。“Transparent”队列的物体会在“Geometry”队列之后渲染并且不写入深度缓冲区除非手动开启ZWrite On但这通常会导致错误的遮挡。理解这一点对于处理半透明物体的前后排序问题至关重要。有时为了获得正确的透明效果你可能需要将物体拆分成多个部分或者使用AlphaTest队列配合镂空纹理。4.3 Shader变体管理与优化这是Unity Shader开发中性能与兼容性的核心矛盾点。变体由#pragma multi_compile和#pragma shader_feature产生。multi_compile始终为所有关键字组合编译变体。例如#pragma multi_compile FANCY_ON FANCY_OFF会编译两个变体无论材质是否用到。shader_feature仅在材质实际使用了某个关键字时才编译对应的变体。这能有效减少构建后Shader文件的大小。但注意在编辑器模式下为了预览所有shader_feature变体都会被编译。变体爆炸问题如果你有多个独立的功能开关比如_NORMALMAP,_PARALLAXMAP,_EMISSION每个都有ON/OFF两种状态那么变体数量就是2的N次方。3个开关是8个变体5个开关就是32个变体这会导致Shader编译时间极长内存占用巨大。优化策略使用Shader变体集合在Graphics Settings中预定义常用的变体组合减少运行时动态编译。合理使用shader_feature对于非核心、不常用的功能使用shader_feature。功能打包将多个互斥的功能合并到一个枚举中用#pragma multi_compile _ FEATURE_A FEATURE_B FEATURE_C代替多个独立的布尔开关。剥离无用变体使用UnityEditor.Rendering.ShaderUtil.ClearShaderVariantCollection或相关构建后处理脚本清理项目中从未被材质使用的Shader变体。4.4 不同渲染管线下的结构差异随着URP和HDRP的普及Shader结构也发生了一些变化。理解这些差异至关重要。Built-in Render Pipeline就是我们上面讨论的经典结构。灵活性最高但需要手动管理很多渲染状态和光照。Universal Render PipelineShaderLab头通常以Shader “Universal Render Pipeline/Lit”这样的路径开始。Properties基本不变但URP提供了更多内置属性特性如[MainTexture]和[MainColor]用于标记主纹理和主颜色以便SRP Batcher优化。SubShader Tags“RenderPipeline”“UniversalPipeline”标签是必须的用于标识该Shader属于URP。Pass LightMode核心的前向渲染Pass使用Tags{“LightMode”“UniversalForward”}。阴影Pass使用“LightMode”“ShadowCaster”。深度纹理Pass使用“LightMode”“DepthOnly”。HLSLINCLUDEURP鼓励使用HLSLINCLUDE和ENDHLSL块来包裹多个Pass共享的代码和包含文件避免重复。包含文件不再使用UnityCG.cginc而是使用URP特定的Packages/com.unity.render-pipelines.universal/ShaderLibrary/…下的文件如Core.hlsl、Lighting.hlsl。光照信息获取URP通过Light结构体和GetMainLight()、GetAdditionalLight()等函数来获取光照数据而不是直接访问_LightColor0等内置变量。High Definition Render Pipeline结构更为复杂和模块化强烈依赖Shader Graph手写HDRP Shader门槛很高通常需要继承自HDRP/…预写的Shader模板。避坑指南当你从网络下载一个为Built-in管线编写的Shader想用到URP项目时直接拖入大概率会失败或显示粉红色。你需要进行手动转换核心工作是1. 修改包含文件路径。2. 替换光照计算相关函数和变量。3. 更新Pass的LightMode标签。这是一个细致活建议先寻找官方或社区提供的URP版本或者使用Amplify Shader Editor这类工具的转换功能。5. 从结构出发实战问题排查与调试理解了结构很多常见的Shader问题就迎刃而解了。下面是一些实战排查思路。问题1材质显示为“粉红色”Missing Shader排查步骤检查Shader文件名和路径是否正确是否被移动或删除。检查Shader的编译错误。在Console窗口将错误信息切换到“Compilation Errors”模式查看该Shader是否有语法错误。错误信息通常会指向具体的行号。检查当前渲染管线。Built-in管线的Shader不能在URP项目中使用反之亦然。检查Edit - Project Settings - Graphics中的Scriptable Render Pipeline Settings是否设置正确。检查SubShader的兼容性。可能是所有SubShader的硬件要求如shader model 3.0当前平台都不支持且没有设置有效的Fallback。问题2纹理采样错乱UV不对排查步骤确认在CGPROGRAM中声明了纹理的_ST变量如float4 _MainTex_ST;。确认在顶点着色器中使用了TRANSFORM_TEX宏来正确应用材质的Tiling和Offset设置。检查模型导入设置中的“Generate Lightmap UVs”是否意外影响了主UV通道。问题3透明效果不正常排序错乱排查步骤确认材质的渲染队列“Queue”是否正确设置为“Transparent”。检查Pass中的混合模式Blend和深度写入ZWrite设置是否正确。对于标准Alpha混合通常为Blend SrcAlpha OneMinusSrcAlpha和ZWrite Off。检查模型本身是否有交叉的面片。透明物体的渲染顺序依赖网格提交顺序交叉面片会导致无法正确排序。可以考虑将模型拆分为多个不交叉的部分。问题4Shader变体太多导致构建包体巨大或运行时卡顿排查步骤在编辑器中选择Shader文件在Inspector面板查看“Compiled code”部分可以预览所有变体。分析#pragma multi_compile和#pragma shader_feature指令是否包含了不必要的、或可合并的关键字。使用Shader.Find()或Material.EnableKeyword()在代码中动态启用关键字时确保只在需要时启用并在不需要时禁用。调试技巧使用Frame DebuggerWindow - Analysis - Frame Debugger。逐帧、逐Draw Call地查看渲染过程可以看到每个Pass具体绘制了什么使用的Shader和参数是什么。这是诊断渲染问题最强大的工具。在片元着色器中输出中间值将计算过程中的向量如法线、光照方向映射到颜色并直接输出可以直观地查看其是否正确。例如return float4(worldNormal * 0.5 0.5, 1.0);来可视化世界空间法线。利用Shader的Inspector面板在Shader文件的Inspector底部有“Compile and show code”按钮可以查看为当前平台编译后的最终HLSL/GLSL等代码对于理解底层和排查平台特异性问题很有帮助。理解Unity Shader的结构绝非一蹴而就。它需要你在不断的实践、试错和阅读他人代码中逐步深化。建议你从修改一个最简单的Unlit Shader开始尝试添加一个颜色属性再添加一张纹理然后试着实现一个Lambert漫反射光照模型。每一步都对照着本文讲的结构看看你修改的是哪个部分。当你能够流畅地搭建起一个包含属性、多个SubShader适配、以及完整光照计算的Shader时你就已经掌握了这门“图形学说明书”的阅读和撰写方法那些曾经令人生畏的水墨、体积光、扰动效果其背后的实现原理对你而言也将不再是黑盒。
（支持资料、图片参考_相关定制）_)
