1. 从一次材质翻车说起为什么内置管线的Shader搬到URP就废了如果你是从内置管线Built-in Render Pipeline一路做过来的Unity开发者大概率经历过这样一个场景手里有一个调得好好的自定义光照Shader模型质感、高光位置、阴影过渡都符合预期结果项目一升级到URPUniversal Render Pipeline同一个Shader贴上去模型要么变成一片死黑要么亮得像塑料玩具高光位置完全对不上阴影也糊成一团。你打开Shader代码一看语法没报错编译也通过了但效果就是不对。这不是你的Shader写错了而是内置管线和URP在光照处理上的底层逻辑根本就是两套体系。内置管线用的是前向渲染路径下的多Pass光照模型每个光源单独一个Pass光照计算在Shader内部通过_WorldSpaceLightPos0、_LightColor0这些内置变量完成。而URP把光照计算从Shader里抽了出来交给了统一的Lighting.hlsl库函数Shader本身只需要负责表面属性法线、粗糙度、金属度等光照由管线统一调度。这个差异带来的直接后果是你在内置管线里写的所有光照相关代码在URP里几乎全部要重写。不是改几个变量名的问题而是整个光照计算的思路要换。我见过不少团队在这个环节上卡了整整一周最后发现是光照方向的计算方式变了导致法线贴图的效果完全错位。这篇文章就是把这个坑彻底讲清楚。我会从光照模型的核心差异入手拆解内置管线和URP在光照计算上的关键区别然后给出具体的Shader改写方案和实操步骤。不管你是刚接触URP的新手还是正在做管线迁移的老手都能从里面找到可以直接抄作业的代码和避坑经验。2. 光照模型的核心差异从多Pass到单Pass的范式转移2.1 内置管线的多Pass光照机制内置管线的光照处理方式理解起来其实很直观每个光源一个Pass。假设场景里有一个平行光、两个点光源那么一个受光照影响的Shader会被执行三次——平行光一次每个点光源各一次。每次执行时Unity会把当前光源的信息填入_WorldSpaceLightPos0、_LightColor0、_LightDirection等内置变量Shader根据这些变量计算当前光源的贡献然后把结果叠加到帧缓冲里。这种方式的优点是逻辑清晰每个Pass只关心一个光源Shader代码写起来比较直观。但缺点也很明显光源数量一多Draw Call就爆炸。十个光源就是十次Pass每个Pass都要重新计算一遍顶点变换和纹理采样性能开销随光源数量线性增长。而且多Pass之间的混合是加法混合容易出现过度曝光和光照溢出的问题。在内置管线的Shader里你通常会看到这样的结构Pass { Tags { LightMode ForwardBase } // 处理主平行光 } Pass { Tags { LightMode ForwardAdd } Blend One One // 处理额外光源 }ForwardBase负责主光源和环境光ForwardAdd负责其他逐像素光源。每个Pass里你都要自己写光照衰减、阴影采样、高光计算的代码。这套写法在Built-in里跑了十几年资料多、教程多但搬到URP就完全行不通了。2.2 URP的单Pass多光源架构URP的做法完全不同。它把所有光源的信息打包成一个数组在单次Pass里统一处理。具体来说URP在CPU端会把场景中影响该物体的光源数据位置、方向、颜色、衰减参数等整理好通过StructuredBuffer或者常量缓冲区传给GPU。Shader里通过GetMainLight()和GetAdditionalLightsCount()、GetAdditionalLight()这些函数来获取光源信息。这意味着什么呢你的Shader不再需要关心有几个光源也不需要写多个Pass。你只需要在片元着色器里调用URP提供的Lighting.hlsl中的光照函数传入表面数据法线、位置、粗糙度等函数内部会自动遍历所有光源并累加贡献。这种架构的好处是Draw Call大幅降低无论多少光源都只在一个Pass里完成光照计算统一所有光源用同一套BRDF模型不会出现不同Pass之间光照风格不一致的问题扩展性强新增光源类型如聚光灯、区域光只需要管线层面支持Shader代码不用改但代价是灵活性降低。在内置管线里你可以为每个光源单独定制光照模型比如主光源用Blinn-Phong点光源用Lambert。在URP里所有光源走同一套PBR光照你想改就得改管线源码或者用自定义的Lighting函数覆盖。2.3 关键变量与函数的对照表为了让你更直观地看到差异我整理了一张内置管线和URP常用光照变量的对照表功能内置管线URP主光源方向_WorldSpaceLightPos0.xyzGetMainLight().direction主光源颜色_LightColor0.rgbGetMainLight().color主光源衰减UNITY_LIGHT_ATTENUATIONGetMainLight().distanceAttenuation主光源阴影SHADOW_ATTENUATIONGetMainLight().shadowAttenuation额外光源数量通过Pass数量隐式处理GetAdditionalLightsCount()额外光源数据_WorldSpaceLightPos0每个Pass不同GetAdditionalLight(i, positionWS)环境光UNITY_LIGHTMODEL_AMBIENTSampleSH(normalWS)或unity_AmbientSky光照衰减纹理_LightTexture0管线内部处理无需手动采样这张表里的每一行都对应着一次实际迁移中必然会遇到的修改点。我见过有人只改了光源方向变量名结果阴影完全不对就是因为阴影衰减的获取方式也变了。注意URP的GetMainLight()返回的是一个Light结构体包含direction、color、distanceAttenuation、shadowAttenuation等字段。这个结构体的定义在Lighting.hlsl里不同URP版本可能有细微差异建议直接打开包管理器里的URP源码查看当前版本的准确定义。3. 逐像素光照计算从手写公式到调用库函数3.1 内置管线里的手写光照计算在内置管线里写一个简单的漫反射Shader你通常需要这样写// 顶点着色器里计算 float3 worldNormal UnityObjectToWorldNormal(v.normal); float3 worldPos mul(unity_ObjectToWorld, v.vertex).xyz; // 片元着色器里计算 float3 lightDir normalize(_WorldSpaceLightPos0.xyz); float NdotL saturate(dot(worldNormal, lightDir)); float3 diffuse _LightColor0.rgb * NdotL * atten; float3 ambient UNITY_LIGHTMODEL_AMBIENT.rgb; float3 finalColor diffuse ambient;这段代码在内置管线里跑没问题但搬到URP里_WorldSpaceLightPos0和_LightColor0虽然还能编译通过URP为了兼容保留了一些内置变量但值可能是错的。因为URP的光源数据不再通过这些变量传递而是通过Light结构体。你如果继续用旧变量得到的光照方向可能是零向量或者上一个光源的残留值导致光照完全错乱。3.2 URP里的标准光照调用方式URP的正确写法是这样的// 引入URP光照库 #include Packages/com.unity.render-pipelines.universal/ShaderLibrary/Lighting.hlsl // 片元着色器里 float3 normalWS normalize(input.normalWS); float3 positionWS input.positionWS; // 获取主光源 Light mainLight GetMainLight(); float NdotL saturate(dot(normalWS, mainLight.direction)); float3 diffuse mainLight.color * NdotL * mainLight.distanceAttenuation * mainLight.shadowAttenuation; // 获取环境光 float3 ambient SampleSH(normalWS); // 处理额外光源 int additionalLightsCount GetAdditionalLightsCount(); for (int i 0; i additionalLightsCount; i) { Light light GetAdditionalLight(i, positionWS); float NdotL saturate(dot(normalWS, light.direction)); diffuse light.color * NdotL * light.distanceAttenuation * light.shadowAttenuation; } float3 finalColor diffuse ambient;这段代码和内置管线的版本相比有几个关键变化第一光源方向不再需要手动归一化。GetMainLight().direction返回的已经是归一化后的方向向量你直接拿来做点积就行。内置管线里_WorldSpaceLightPos0对于平行光来说方向是反的指向光源需要取负或者调整URP里统一成了从表面指向光源的方向用起来更符合直觉。第二衰减和阴影合并到了Light结构体里。内置管线里你要分别处理距离衰减通过_LightTexture0采样和阴影衰减通过SHADOW_ATTENUATION宏URP把它们统一成了distanceAttenuation和shadowAttenuation两个字段直接乘进去就行。第三额外光源需要手动遍历。内置管线里额外光源是通过多Pass自动处理的你不需要写循环。URP里你必须自己写for循环遍历GetAdditionalLightsCount()对每个光源调用GetAdditionalLight(i, positionWS)。这个循环的写法有讲究后面会详细说。3.3 逐像素光照的实操注意事项在实际改写Shader的过程中有几个地方特别容易出错我一个个说。第一个坑是法线空间。内置管线里你经常在顶点着色器里用UnityObjectToWorldNormal把法线转到世界空间然后在片元着色器里直接用。URP里这个函数还能用但更推荐用TransformObjectToWorldNormal因为它在处理非统一缩放时更准确。如果你发现法线贴图的效果不对先检查法线变换函数是不是用错了。第二个坑是位置空间。URP的GetAdditionalLight需要传入世界空间的位置如果你传的是对象空间或者裁剪空间的位置光源方向会完全错乱。顶点着色器里记得用TransformObjectToWorld把顶点位置转到世界空间然后插值到片元着色器。第三个坑是额外光源的循环写法。URP的GetAdditionalLightsCount()返回的是当前物体受影响的额外光源数量这个数量是管线根据光源的Render Mode和距离自动计算的。如果你在Shader里写死了循环次数比如for (int i 0; i 4; i)那么当场景里只有两个额外光源时后两次循环会拿到无效数据导致光照异常。正确的做法是始终用GetAdditionalLightsCount()作为循环上界。实操心得在URP里调试光照问题时可以临时把GetAdditionalLightsCount()的返回值输出到屏幕颜色上看看管线实际传了几个光源过来。如果数量和你预期的不一样检查一下光源的Render Mode是不是设成了Not Important或者物体的Rendering Layer Mask有没有排除掉某些光源。4. 阴影与环境光URP里最容易被忽略的两个细节4.1 阴影采样的差异与常见问题内置管线里阴影采样通常是通过SHADOW_ATTENUATION宏完成的这个宏内部会根据当前Pass的类型Base还是Add和光源类型平行光还是点光源选择不同的阴影贴图和采样方式。你不需要关心阴影贴图是怎么生成的只需要调用宏就行。URP里阴影采样被封装得更彻底。GetMainLight()返回的Light结构体里已经包含了shadowAttenuation字段你直接乘进去就行。但这里有一个非常容易踩的坑GetMainLight()默认不接收阴影参数如果你想要阴影效果必须调用带参数的版本Light mainLight GetMainLight(GetShadowCoord(positionWS));GetShadowCoord会根据当前平台和光源类型计算阴影坐标然后GetMainLight内部会用这个坐标去采样阴影贴图。如果你直接调用无参的GetMainLight()shadowAttenuation会始终返回1也就是没有阴影。这个设计的好处是解耦了阴影计算和光照计算你可以选择性地开启阴影。但坏处是新手很容易忘记传阴影坐标然后纳闷为什么阴影不显示。另外URP的阴影距离和级联设置是在URP Asset里统一配置的不像内置管线可以在Quality Settings里针对每个质量等级单独设置。如果你发现阴影在远处突然消失或者近处阴影锯齿严重需要去URP Asset的Shadows面板调整Max Distance和Cascade Count。4.2 环境光与球谐光照的处理内置管线里环境光通常通过UNITY_LIGHTMODEL_AMBIENT获取这个值来自Lighting面板的Ambient设置。在URP里环境光的获取方式变成了SampleSH(normalWS)它采样的是球谐函数Spherical Harmonics计算出的环境光。球谐光照的好处是它可以根据法线方向给出不同方向的环境光颜色而不是一个统一的常量。比如天空是蓝色、地面是灰色的环境下朝上的法线会偏蓝朝下的法线会偏灰。这比内置管线的常量环境光真实得多。但这里也有一个坑SampleSH需要传入世界空间法线。如果你传的是对象空间法线环境光的方向会跟着物体旋转看起来就像环境光在跟着物体转非常诡异。我见过有人因为这个原因以为URP的环境光有Bug折腾了半天才发现是法线空间搞错了。还有一个细节是URP的环境光强度可以在URP Asset里通过Environment Lighting的Intensity Multiplier调节。如果你从内置管线迁移过来发现环境光太亮或太暗先检查这个乘数是不是被改过。4.3 阴影与环境光的联合调试技巧在实际项目中阴影和环境光的问题经常混在一起导致你很难判断到底是哪个环节出了问题。我的经验是分步调试第一步先把环境光关掉在URP Asset里把Intensity Multiplier设为0只保留主光源和阴影。如果这时候阴影正常说明阴影采样没问题。第二步把主光源的阴影关掉在光源组件里把Shadows设为No Shadows只保留环境光。如果这时候环境光方向正确说明球谐采样没问题。第三步两者都打开检查叠加效果。如果出现阴影区域过暗或过亮检查环境光是否在阴影区域也被正确采样。URP默认在阴影区域也会采样环境光这符合物理规律但如果你想要更风格化的效果可以在Shader里手动降低阴影区域的环境光贡献。注意URP的阴影贴图默认使用屏幕空间阴影Screen Space Shadows这会导致一些在半透明物体上的阴影表现和内置管线不同。如果你的项目里有大量半透明材质建议在URP Asset里关闭Screen Space Shadows改用传统的阴影贴图采样。5. 完整Shader改写实例从Built-in到URP的逐步迁移5.1 迁移前的内置管线Shader假设我们有一个简单的Blinn-Phong光照Shader内置管线版本如下Shader Custom/BuiltinBlinnPhong { Properties { _MainTex (Texture, 2D) white {} _SpecularPower (Specular Power, Range(1, 100)) 20 _SpecularIntensity (Specular Intensity, Range(0, 2)) 0.5 } SubShader { Tags { RenderType Opaque } Pass { Tags { LightMode ForwardBase } CGPROGRAM #pragma vertex vert #pragma fragment frag #include UnityCG.cginc #include Lighting.cginc struct appdata { float4 vertex : POSITION; float3 normal : NORMAL; float2 uv : TEXCOORD0; }; struct v2f { float4 pos : SV_POSITION; float2 uv : TEXCOORD0; float3 worldNormal : TEXCOORD1; float3 worldPos : TEXCOORD2; }; sampler2D _MainTex; float4 _MainTex_ST; float _SpecularPower; float _SpecularIntensity; v2f vert (appdata v) { v2f o; o.pos UnityObjectToClipPos(v.vertex); o.uv TRANSFORM_TEX(v.uv, _MainTex); o.worldNormal UnityObjectToWorldNormal(v.normal); o.worldPos mul(unity_ObjectToWorld, v.vertex).xyz; return o; } fixed4 frag (v2f i) : SV_Target { float3 normal normalize(i.worldNormal); float3 lightDir normalize(_WorldSpaceLightPos0.xyz); float3 viewDir normalize(_WorldSpaceCameraPos - i.worldPos); float3 halfDir normalize(lightDir viewDir); float NdotL saturate(dot(normal, lightDir)); float NdotH saturate(dot(normal, halfDir)); float spec pow(NdotH, _SpecularPower) * _SpecularIntensity; float3 albedo tex2D(_MainTex, i.uv).rgb; float3 diffuse albedo * _LightColor0.rgb * NdotL; float3 specular _LightColor0.rgb * spec; float3 ambient UNITY_LIGHTMODEL_AMBIENT.rgb * albedo; return fixed4(diffuse specular ambient, 1); } ENDCG } } }这个Shader在内置管线里工作正常但直接放到URP项目里光照会完全错乱。5.2 改写为URP版本的完整代码下面是改写后的URP版本Shader Custom/URPBlinnPhong { Properties { _MainTex (Texture, 2D) white {} _SpecularPower (Specular Power, Range(1, 100)) 20 _SpecularIntensity (Specular Intensity, Range(0, 2)) 0.5 } SubShader { Tags { RenderType Opaque RenderPipeline UniversalPipeline } Pass { Tags { LightMode UniversalForward } HLSLPROGRAM #pragma vertex vert #pragma fragment frag #include Packages/com.unity.render-pipelines.universal/ShaderLibrary/Core.hlsl #include Packages/com.unity.render-pipelines.universal/ShaderLibrary/Lighting.hlsl struct appdata { float4 vertex : POSITION; float3 normal : NORMAL; float2 uv : TEXCOORD0; }; struct v2f { float4 pos : SV_POSITION; float2 uv : TEXCOORD0; float3 worldNormal : TEXCOORD1; float3 worldPos : TEXCOORD2; }; sampler2D _MainTex; float4 _MainTex_ST; float _SpecularPower; float _SpecularIntensity; v2f vert (appdata v) { v2f o; o.pos TransformObjectToHClip(v.vertex); o.uv TRANSFORM_TEX(v.uv, _MainTex); o.worldNormal TransformObjectToWorldNormal(v.normal); o.worldPos TransformObjectToWorld(v.vertex.xyz); return o; } half4 frag (v2f i) : SV_Target { float3 normal normalize(i.worldNormal); float3 viewDir normalize(GetWorldSpaceViewDir(i.worldPos)); float3 albedo tex2D(_MainTex, i.uv).rgb; // 主光源 Light mainLight GetMainLight(GetShadowCoord(i.worldPos)); float3 lightDir mainLight.direction; float3 halfDir normalize(lightDir viewDir); float NdotL saturate(dot(normal, lightDir)); float NdotH saturate(dot(normal, halfDir)); float spec pow(NdotH, _SpecularPower) * _SpecularIntensity; float3 diffuse albedo * mainLight.color * NdotL * mainLight.distanceAttenuation * mainLight.shadowAttenuation; float3 specular mainLight.color * spec * mainLight.shadowAttenuation; // 额外光源 int additionalLightsCount GetAdditionalLightsCount(); for (int j 0; j additionalLightsCount; j) { Light light GetAdditionalLight(j, i.worldPos); float3 halfDirAdd normalize(light.direction viewDir); float NdotLAdd saturate(dot(normal, light.direction)); float NdotHAdd saturate(dot(normal, halfDirAdd)); float specAdd pow(NdotHAdd, _SpecularPower) * _SpecularIntensity; diffuse albedo * light.color * NdotLAdd * light.distanceAttenuation * light.shadowAttenuation; specular light.color * specAdd * light.shadowAttenuation; } // 环境光 float3 ambient SampleSH(normal) * albedo; return half4(diffuse specular ambient, 1); } ENDHLSL } } }5.3 改写过程中的关键修改点解析对比两个版本有几个关键修改点需要特别注意。第一Shader标签变了。内置管线用Tags { LightMode ForwardBase }URP用Tags { LightMode UniversalForward }。这个标签决定了Shader在URP的哪个阶段被执行写错了会导致Shader完全不渲染。第二CGPROGRAM换成了HLSLPROGRAM。虽然两者语法基本兼容但URP的库函数是用HLSL写的用CGPROGRAM可能会遇到一些宏定义冲突。建议统一用HLSLPROGRAM。第三顶点变换函数变了。UnityObjectToClipPos换成了TransformObjectToHClipmul(unity_ObjectToWorld, v.vertex)换成了TransformObjectToWorld。这些新函数在Core.hlsl里定义内部处理了更多边界情况。第四光照计算完全重写。这是改动最大的部分。内置管线里直接操作_WorldSpaceLightPos0和_LightColor0URP里通过GetMainLight()和GetAdditionalLight()获取光源数据。注意GetMainLight()的参数是阴影坐标不传的话没有阴影。第五额外光源需要手动循环。内置管线里额外光源是自动多Pass处理的URP里必须写for循环。循环里对每个光源都要重新计算高光和漫反射不能只算漫反射。第六环境光从常量变成了球谐采样。UNITY_LIGHTMODEL_AMBIENT换成了SampleSH(normal)需要传入世界空间法线。实操心得在改写过程中建议先用一个最简单的漫反射Shader做验证确认光源方向、颜色、衰减都正确后再逐步加上高光、阴影、额外光源。一次性改完再调试很容易因为多个问题叠加而找不到根源。6. 常见问题与排查技巧实录6.1 光照方向反了或高光位置不对这是最常见的问题通常有以下几个原因法线空间错误检查TransformObjectToWorldNormal是否用在了正确的位置。如果你在顶点着色器里转了世界法线片元着色器里直接normalize就行不要再转一次。光源方向取反URP的GetMainLight().direction是从表面指向光源的方向和内置管线的_WorldSpaceLightPos0方向相反。如果你从内置管线迁移过来记得把点积的顺序调整一下。视图方向计算错误GetWorldSpaceViewDir返回的是从表面指向相机的方向和内置管线的_WorldSpaceCameraPos - worldPos一致。如果你手动计算注意不要搞反。6.2 阴影不显示或显示异常阴影问题通常集中在以下几个方面问题现象可能原因解决方法完全没有阴影GetMainLight()没传阴影坐标改用GetMainLight(GetShadowCoord(positionWS))阴影边缘锯齿严重阴影贴图分辨率低在URP Asset里提高Shadow Resolution远处阴影消失阴影距离太短增大URP Asset里的Max Distance阴影区域过暗环境光在阴影区域贡献不足检查SampleSH是否被正确调用半透明物体阴影异常屏幕空间阴影不兼容关闭URP Asset里的Screen Space Shadows6.3 额外光源不生效或数量不对额外光源的问题通常和光源设置有关光源的Render Mode设成了Not Important这种光源不会被计入GetAdditionalLightsCount()只会作为顶点光源或者SH光源处理。把它改成Important或Auto。URP Asset里的Additional Lights设成了Disabled在URP Asset的Lighting面板里把Additional Lights设为Per Pixel。物体的Rendering Layer Mask排除了光源检查光源的Rendering Layer Mask和物体的Rendering Layer Mask是否有交集。循环上界写死了始终用GetAdditionalLightsCount()作为循环上界不要写死数字。6.4 环境光过亮或过暗环境光的问题通常和URP Asset的设置有关Intensity Multiplier被改过在URP Asset的Environment Lighting面板里检查这个值默认是1。SampleSH传入了错误的空间法线确保传入的是世界空间法线不是对象空间。环境光模式设置不当URP支持Skybox、Gradient、Color三种环境光模式不同模式下的球谐系数不同检查是否选对了模式。注意如果你在Shader里同时使用了SampleSH和自定义的环境光颜色可能会出现双重环境光叠加的问题。建议要么完全依赖SampleSH要么完全自定义不要混用。7. 管线迁移的实操建议与性能考量7.1 迁移前的准备工作在开始迁移Shader之前有几件事必须先做好第一确认URP版本和Unity版本匹配。不同版本的URP在API上有细微差异比如GetMainLight的参数在URP 10.x和12.x里就不完全一样。建议直接打开Package Manager查看当前URP版本的文档。第二备份所有自定义Shader。迁移过程中你可能会反复修改和回滚没有备份会非常痛苦。建议用Git或者直接复制一份到项目外的文件夹。第三建立一个测试场景。场景里放一个球体、一个平面、一个平行光、两个点光源用来验证光照、阴影、额外光源是否正常。这个场景在迁移过程中会反复用到。7.2 性能对比与优化建议URP的单Pass多光源架构在性能上通常优于内置管线的多Pass方案但也有一些需要注意的地方额外光源的循环开销虽然只有一个Pass但循环里每个光源都要计算完整的BRDF光源多了之后片元着色器的指令数会线性增长。建议在URP Asset里限制Additional Lights的最大数量比如设为4。阴影采样的开销URP的阴影采样比内置管线更统一但屏幕空间阴影在移动端可能有兼容性问题。如果目标平台是移动端建议关闭屏幕空间阴影。球谐环境光的开销SampleSH的计算量很小基本可以忽略。但如果你在片元着色器里多次调用建议把结果缓存到一个变量里。7.3 什么情况下值得迁移不是所有项目都需要从内置管线迁移到URP。如果你的项目满足以下条件迁移的收益会比较明显需要更好的移动端性能表现需要Shader Graph的可视化编辑能力需要统一的光照模型和后期处理栈项目还在早期没有大量依赖内置管线特性的自定义Shader但如果你的项目已经深度依赖内置管线的多Pass光照或者有大量手写的复杂光照Shader迁移的成本可能会很高。这种情况下可以考虑逐步迁移先把新场景和新材质用URP旧内容保持内置管线通过渲染管线切换来过渡。我个人在实际操作中的体会是URP的光照体系虽然一开始需要适应但一旦理解了Light结构体和Lighting.hlsl的设计思路写Shader反而比内置管线更简洁。你不需要再关心光源数量、Pass混合、衰减纹理采样这些底层细节可以把精力集中在材质表现本身。唯一需要警惕的是URP的版本迭代比较快API偶尔会有变动建议在升级URP版本时先跑一遍光照测试场景确认没有回归问题。
1. 从一次材质翻车说起为什么内置管线的Shader搬到URP就废了如果你是从内置管线Built-in Render Pipeline一路做过来的Unity开发者大概率经历过这样一个场景手里有一个调得好好的自定义光照Shader模型质感、高光位置、阴影过渡都符合预期结果项目一升级到URPUniversal Render Pipeline同一个Shader贴上去模型要么变成一片死黑要么亮得像塑料玩具高光位置完全对不上阴影也糊成一团。你打开Shader代码一看语法没报错编译也通过了但效果就是不对。这不是你的Shader写错了而是内置管线和URP在光照处理上的底层逻辑根本就是两套体系。内置管线用的是前向渲染路径下的多Pass光照模型每个光源单独一个Pass光照计算在Shader内部通过_WorldSpaceLightPos0、_LightColor0这些内置变量完成。而URP把光照计算从Shader里抽了出来交给了统一的Lighting.hlsl库函数Shader本身只需要负责表面属性法线、粗糙度、金属度等光照由管线统一调度。这个差异带来的直接后果是你在内置管线里写的所有光照相关代码在URP里几乎全部要重写。不是改几个变量名的问题而是整个光照计算的思路要换。我见过不少团队在这个环节上卡了整整一周最后发现是光照方向的计算方式变了导致法线贴图的效果完全错位。这篇文章就是把这个坑彻底讲清楚。我会从光照模型的核心差异入手拆解内置管线和URP在光照计算上的关键区别然后给出具体的Shader改写方案和实操步骤。不管你是刚接触URP的新手还是正在做管线迁移的老手都能从里面找到可以直接抄作业的代码和避坑经验。2. 光照模型的核心差异从多Pass到单Pass的范式转移2.1 内置管线的多Pass光照机制内置管线的光照处理方式理解起来其实很直观每个光源一个Pass。假设场景里有一个平行光、两个点光源那么一个受光照影响的Shader会被执行三次——平行光一次每个点光源各一次。每次执行时Unity会把当前光源的信息填入_WorldSpaceLightPos0、_LightColor0、_LightDirection等内置变量Shader根据这些变量计算当前光源的贡献然后把结果叠加到帧缓冲里。这种方式的优点是逻辑清晰每个Pass只关心一个光源Shader代码写起来比较直观。但缺点也很明显光源数量一多Draw Call就爆炸。十个光源就是十次Pass每个Pass都要重新计算一遍顶点变换和纹理采样性能开销随光源数量线性增长。而且多Pass之间的混合是加法混合容易出现过度曝光和光照溢出的问题。在内置管线的Shader里你通常会看到这样的结构Pass { Tags { LightMode ForwardBase } // 处理主平行光 } Pass { Tags { LightMode ForwardAdd } Blend One One // 处理额外光源 }ForwardBase负责主光源和环境光ForwardAdd负责其他逐像素光源。每个Pass里你都要自己写光照衰减、阴影采样、高光计算的代码。这套写法在Built-in里跑了十几年资料多、教程多但搬到URP就完全行不通了。2.2 URP的单Pass多光源架构URP的做法完全不同。它把所有光源的信息打包成一个数组在单次Pass里统一处理。具体来说URP在CPU端会把场景中影响该物体的光源数据位置、方向、颜色、衰减参数等整理好通过StructuredBuffer或者常量缓冲区传给GPU。Shader里通过GetMainLight()和GetAdditionalLightsCount()、GetAdditionalLight()这些函数来获取光源信息。这意味着什么呢你的Shader不再需要关心有几个光源也不需要写多个Pass。你只需要在片元着色器里调用URP提供的Lighting.hlsl中的光照函数传入表面数据法线、位置、粗糙度等函数内部会自动遍历所有光源并累加贡献。这种架构的好处是Draw Call大幅降低无论多少光源都只在一个Pass里完成光照计算统一所有光源用同一套BRDF模型不会出现不同Pass之间光照风格不一致的问题扩展性强新增光源类型如聚光灯、区域光只需要管线层面支持Shader代码不用改但代价是灵活性降低。在内置管线里你可以为每个光源单独定制光照模型比如主光源用Blinn-Phong点光源用Lambert。在URP里所有光源走同一套PBR光照你想改就得改管线源码或者用自定义的Lighting函数覆盖。2.3 关键变量与函数的对照表为了让你更直观地看到差异我整理了一张内置管线和URP常用光照变量的对照表功能内置管线URP主光源方向_WorldSpaceLightPos0.xyzGetMainLight().direction主光源颜色_LightColor0.rgbGetMainLight().color主光源衰减UNITY_LIGHT_ATTENUATIONGetMainLight().distanceAttenuation主光源阴影SHADOW_ATTENUATIONGetMainLight().shadowAttenuation额外光源数量通过Pass数量隐式处理GetAdditionalLightsCount()额外光源数据_WorldSpaceLightPos0每个Pass不同GetAdditionalLight(i, positionWS)环境光UNITY_LIGHTMODEL_AMBIENTSampleSH(normalWS)或unity_AmbientSky光照衰减纹理_LightTexture0管线内部处理无需手动采样这张表里的每一行都对应着一次实际迁移中必然会遇到的修改点。我见过有人只改了光源方向变量名结果阴影完全不对就是因为阴影衰减的获取方式也变了。注意URP的GetMainLight()返回的是一个Light结构体包含direction、color、distanceAttenuation、shadowAttenuation等字段。这个结构体的定义在Lighting.hlsl里不同URP版本可能有细微差异建议直接打开包管理器里的URP源码查看当前版本的准确定义。3. 逐像素光照计算从手写公式到调用库函数3.1 内置管线里的手写光照计算在内置管线里写一个简单的漫反射Shader你通常需要这样写// 顶点着色器里计算 float3 worldNormal UnityObjectToWorldNormal(v.normal); float3 worldPos mul(unity_ObjectToWorld, v.vertex).xyz; // 片元着色器里计算 float3 lightDir normalize(_WorldSpaceLightPos0.xyz); float NdotL saturate(dot(worldNormal, lightDir)); float3 diffuse _LightColor0.rgb * NdotL * atten; float3 ambient UNITY_LIGHTMODEL_AMBIENT.rgb; float3 finalColor diffuse ambient;这段代码在内置管线里跑没问题但搬到URP里_WorldSpaceLightPos0和_LightColor0虽然还能编译通过URP为了兼容保留了一些内置变量但值可能是错的。因为URP的光源数据不再通过这些变量传递而是通过Light结构体。你如果继续用旧变量得到的光照方向可能是零向量或者上一个光源的残留值导致光照完全错乱。3.2 URP里的标准光照调用方式URP的正确写法是这样的// 引入URP光照库 #include Packages/com.unity.render-pipelines.universal/ShaderLibrary/Lighting.hlsl // 片元着色器里 float3 normalWS normalize(input.normalWS); float3 positionWS input.positionWS; // 获取主光源 Light mainLight GetMainLight(); float NdotL saturate(dot(normalWS, mainLight.direction)); float3 diffuse mainLight.color * NdotL * mainLight.distanceAttenuation * mainLight.shadowAttenuation; // 获取环境光 float3 ambient SampleSH(normalWS); // 处理额外光源 int additionalLightsCount GetAdditionalLightsCount(); for (int i 0; i additionalLightsCount; i) { Light light GetAdditionalLight(i, positionWS); float NdotL saturate(dot(normalWS, light.direction)); diffuse light.color * NdotL * light.distanceAttenuation * light.shadowAttenuation; } float3 finalColor diffuse ambient;这段代码和内置管线的版本相比有几个关键变化第一光源方向不再需要手动归一化。GetMainLight().direction返回的已经是归一化后的方向向量你直接拿来做点积就行。内置管线里_WorldSpaceLightPos0对于平行光来说方向是反的指向光源需要取负或者调整URP里统一成了从表面指向光源的方向用起来更符合直觉。第二衰减和阴影合并到了Light结构体里。内置管线里你要分别处理距离衰减通过_LightTexture0采样和阴影衰减通过SHADOW_ATTENUATION宏URP把它们统一成了distanceAttenuation和shadowAttenuation两个字段直接乘进去就行。第三额外光源需要手动遍历。内置管线里额外光源是通过多Pass自动处理的你不需要写循环。URP里你必须自己写for循环遍历GetAdditionalLightsCount()对每个光源调用GetAdditionalLight(i, positionWS)。这个循环的写法有讲究后面会详细说。3.3 逐像素光照的实操注意事项在实际改写Shader的过程中有几个地方特别容易出错我一个个说。第一个坑是法线空间。内置管线里你经常在顶点着色器里用UnityObjectToWorldNormal把法线转到世界空间然后在片元着色器里直接用。URP里这个函数还能用但更推荐用TransformObjectToWorldNormal因为它在处理非统一缩放时更准确。如果你发现法线贴图的效果不对先检查法线变换函数是不是用错了。第二个坑是位置空间。URP的GetAdditionalLight需要传入世界空间的位置如果你传的是对象空间或者裁剪空间的位置光源方向会完全错乱。顶点着色器里记得用TransformObjectToWorld把顶点位置转到世界空间然后插值到片元着色器。第三个坑是额外光源的循环写法。URP的GetAdditionalLightsCount()返回的是当前物体受影响的额外光源数量这个数量是管线根据光源的Render Mode和距离自动计算的。如果你在Shader里写死了循环次数比如for (int i 0; i 4; i)那么当场景里只有两个额外光源时后两次循环会拿到无效数据导致光照异常。正确的做法是始终用GetAdditionalLightsCount()作为循环上界。实操心得在URP里调试光照问题时可以临时把GetAdditionalLightsCount()的返回值输出到屏幕颜色上看看管线实际传了几个光源过来。如果数量和你预期的不一样检查一下光源的Render Mode是不是设成了Not Important或者物体的Rendering Layer Mask有没有排除掉某些光源。4. 阴影与环境光URP里最容易被忽略的两个细节4.1 阴影采样的差异与常见问题内置管线里阴影采样通常是通过SHADOW_ATTENUATION宏完成的这个宏内部会根据当前Pass的类型Base还是Add和光源类型平行光还是点光源选择不同的阴影贴图和采样方式。你不需要关心阴影贴图是怎么生成的只需要调用宏就行。URP里阴影采样被封装得更彻底。GetMainLight()返回的Light结构体里已经包含了shadowAttenuation字段你直接乘进去就行。但这里有一个非常容易踩的坑GetMainLight()默认不接收阴影参数如果你想要阴影效果必须调用带参数的版本Light mainLight GetMainLight(GetShadowCoord(positionWS));GetShadowCoord会根据当前平台和光源类型计算阴影坐标然后GetMainLight内部会用这个坐标去采样阴影贴图。如果你直接调用无参的GetMainLight()shadowAttenuation会始终返回1也就是没有阴影。这个设计的好处是解耦了阴影计算和光照计算你可以选择性地开启阴影。但坏处是新手很容易忘记传阴影坐标然后纳闷为什么阴影不显示。另外URP的阴影距离和级联设置是在URP Asset里统一配置的不像内置管线可以在Quality Settings里针对每个质量等级单独设置。如果你发现阴影在远处突然消失或者近处阴影锯齿严重需要去URP Asset的Shadows面板调整Max Distance和Cascade Count。4.2 环境光与球谐光照的处理内置管线里环境光通常通过UNITY_LIGHTMODEL_AMBIENT获取这个值来自Lighting面板的Ambient设置。在URP里环境光的获取方式变成了SampleSH(normalWS)它采样的是球谐函数Spherical Harmonics计算出的环境光。球谐光照的好处是它可以根据法线方向给出不同方向的环境光颜色而不是一个统一的常量。比如天空是蓝色、地面是灰色的环境下朝上的法线会偏蓝朝下的法线会偏灰。这比内置管线的常量环境光真实得多。但这里也有一个坑SampleSH需要传入世界空间法线。如果你传的是对象空间法线环境光的方向会跟着物体旋转看起来就像环境光在跟着物体转非常诡异。我见过有人因为这个原因以为URP的环境光有Bug折腾了半天才发现是法线空间搞错了。还有一个细节是URP的环境光强度可以在URP Asset里通过Environment Lighting的Intensity Multiplier调节。如果你从内置管线迁移过来发现环境光太亮或太暗先检查这个乘数是不是被改过。4.3 阴影与环境光的联合调试技巧在实际项目中阴影和环境光的问题经常混在一起导致你很难判断到底是哪个环节出了问题。我的经验是分步调试第一步先把环境光关掉在URP Asset里把Intensity Multiplier设为0只保留主光源和阴影。如果这时候阴影正常说明阴影采样没问题。第二步把主光源的阴影关掉在光源组件里把Shadows设为No Shadows只保留环境光。如果这时候环境光方向正确说明球谐采样没问题。第三步两者都打开检查叠加效果。如果出现阴影区域过暗或过亮检查环境光是否在阴影区域也被正确采样。URP默认在阴影区域也会采样环境光这符合物理规律但如果你想要更风格化的效果可以在Shader里手动降低阴影区域的环境光贡献。注意URP的阴影贴图默认使用屏幕空间阴影Screen Space Shadows这会导致一些在半透明物体上的阴影表现和内置管线不同。如果你的项目里有大量半透明材质建议在URP Asset里关闭Screen Space Shadows改用传统的阴影贴图采样。5. 完整Shader改写实例从Built-in到URP的逐步迁移5.1 迁移前的内置管线Shader假设我们有一个简单的Blinn-Phong光照Shader内置管线版本如下Shader Custom/BuiltinBlinnPhong { Properties { _MainTex (Texture, 2D) white {} _SpecularPower (Specular Power, Range(1, 100)) 20 _SpecularIntensity (Specular Intensity, Range(0, 2)) 0.5 } SubShader { Tags { RenderType Opaque } Pass { Tags { LightMode ForwardBase } CGPROGRAM #pragma vertex vert #pragma fragment frag #include UnityCG.cginc #include Lighting.cginc struct appdata { float4 vertex : POSITION; float3 normal : NORMAL; float2 uv : TEXCOORD0; }; struct v2f { float4 pos : SV_POSITION; float2 uv : TEXCOORD0; float3 worldNormal : TEXCOORD1; float3 worldPos : TEXCOORD2; }; sampler2D _MainTex; float4 _MainTex_ST; float _SpecularPower; float _SpecularIntensity; v2f vert (appdata v) { v2f o; o.pos UnityObjectToClipPos(v.vertex); o.uv TRANSFORM_TEX(v.uv, _MainTex); o.worldNormal UnityObjectToWorldNormal(v.normal); o.worldPos mul(unity_ObjectToWorld, v.vertex).xyz; return o; } fixed4 frag (v2f i) : SV_Target { float3 normal normalize(i.worldNormal); float3 lightDir normalize(_WorldSpaceLightPos0.xyz); float3 viewDir normalize(_WorldSpaceCameraPos - i.worldPos); float3 halfDir normalize(lightDir viewDir); float NdotL saturate(dot(normal, lightDir)); float NdotH saturate(dot(normal, halfDir)); float spec pow(NdotH, _SpecularPower) * _SpecularIntensity; float3 albedo tex2D(_MainTex, i.uv).rgb; float3 diffuse albedo * _LightColor0.rgb * NdotL; float3 specular _LightColor0.rgb * spec; float3 ambient UNITY_LIGHTMODEL_AMBIENT.rgb * albedo; return fixed4(diffuse specular ambient, 1); } ENDCG } } }这个Shader在内置管线里工作正常但直接放到URP项目里光照会完全错乱。5.2 改写为URP版本的完整代码下面是改写后的URP版本Shader Custom/URPBlinnPhong { Properties { _MainTex (Texture, 2D) white {} _SpecularPower (Specular Power, Range(1, 100)) 20 _SpecularIntensity (Specular Intensity, Range(0, 2)) 0.5 } SubShader { Tags { RenderType Opaque RenderPipeline UniversalPipeline } Pass { Tags { LightMode UniversalForward } HLSLPROGRAM #pragma vertex vert #pragma fragment frag #include Packages/com.unity.render-pipelines.universal/ShaderLibrary/Core.hlsl #include Packages/com.unity.render-pipelines.universal/ShaderLibrary/Lighting.hlsl struct appdata { float4 vertex : POSITION; float3 normal : NORMAL; float2 uv : TEXCOORD0; }; struct v2f { float4 pos : SV_POSITION; float2 uv : TEXCOORD0; float3 worldNormal : TEXCOORD1; float3 worldPos : TEXCOORD2; }; sampler2D _MainTex; float4 _MainTex_ST; float _SpecularPower; float _SpecularIntensity; v2f vert (appdata v) { v2f o; o.pos TransformObjectToHClip(v.vertex); o.uv TRANSFORM_TEX(v.uv, _MainTex); o.worldNormal TransformObjectToWorldNormal(v.normal); o.worldPos TransformObjectToWorld(v.vertex.xyz); return o; } half4 frag (v2f i) : SV_Target { float3 normal normalize(i.worldNormal); float3 viewDir normalize(GetWorldSpaceViewDir(i.worldPos)); float3 albedo tex2D(_MainTex, i.uv).rgb; // 主光源 Light mainLight GetMainLight(GetShadowCoord(i.worldPos)); float3 lightDir mainLight.direction; float3 halfDir normalize(lightDir viewDir); float NdotL saturate(dot(normal, lightDir)); float NdotH saturate(dot(normal, halfDir)); float spec pow(NdotH, _SpecularPower) * _SpecularIntensity; float3 diffuse albedo * mainLight.color * NdotL * mainLight.distanceAttenuation * mainLight.shadowAttenuation; float3 specular mainLight.color * spec * mainLight.shadowAttenuation; // 额外光源 int additionalLightsCount GetAdditionalLightsCount(); for (int j 0; j additionalLightsCount; j) { Light light GetAdditionalLight(j, i.worldPos); float3 halfDirAdd normalize(light.direction viewDir); float NdotLAdd saturate(dot(normal, light.direction)); float NdotHAdd saturate(dot(normal, halfDirAdd)); float specAdd pow(NdotHAdd, _SpecularPower) * _SpecularIntensity; diffuse albedo * light.color * NdotLAdd * light.distanceAttenuation * light.shadowAttenuation; specular light.color * specAdd * light.shadowAttenuation; } // 环境光 float3 ambient SampleSH(normal) * albedo; return half4(diffuse specular ambient, 1); } ENDHLSL } } }5.3 改写过程中的关键修改点解析对比两个版本有几个关键修改点需要特别注意。第一Shader标签变了。内置管线用Tags { LightMode ForwardBase }URP用Tags { LightMode UniversalForward }。这个标签决定了Shader在URP的哪个阶段被执行写错了会导致Shader完全不渲染。第二CGPROGRAM换成了HLSLPROGRAM。虽然两者语法基本兼容但URP的库函数是用HLSL写的用CGPROGRAM可能会遇到一些宏定义冲突。建议统一用HLSLPROGRAM。第三顶点变换函数变了。UnityObjectToClipPos换成了TransformObjectToHClipmul(unity_ObjectToWorld, v.vertex)换成了TransformObjectToWorld。这些新函数在Core.hlsl里定义内部处理了更多边界情况。第四光照计算完全重写。这是改动最大的部分。内置管线里直接操作_WorldSpaceLightPos0和_LightColor0URP里通过GetMainLight()和GetAdditionalLight()获取光源数据。注意GetMainLight()的参数是阴影坐标不传的话没有阴影。第五额外光源需要手动循环。内置管线里额外光源是自动多Pass处理的URP里必须写for循环。循环里对每个光源都要重新计算高光和漫反射不能只算漫反射。第六环境光从常量变成了球谐采样。UNITY_LIGHTMODEL_AMBIENT换成了SampleSH(normal)需要传入世界空间法线。实操心得在改写过程中建议先用一个最简单的漫反射Shader做验证确认光源方向、颜色、衰减都正确后再逐步加上高光、阴影、额外光源。一次性改完再调试很容易因为多个问题叠加而找不到根源。6. 常见问题与排查技巧实录6.1 光照方向反了或高光位置不对这是最常见的问题通常有以下几个原因法线空间错误检查TransformObjectToWorldNormal是否用在了正确的位置。如果你在顶点着色器里转了世界法线片元着色器里直接normalize就行不要再转一次。光源方向取反URP的GetMainLight().direction是从表面指向光源的方向和内置管线的_WorldSpaceLightPos0方向相反。如果你从内置管线迁移过来记得把点积的顺序调整一下。视图方向计算错误GetWorldSpaceViewDir返回的是从表面指向相机的方向和内置管线的_WorldSpaceCameraPos - worldPos一致。如果你手动计算注意不要搞反。6.2 阴影不显示或显示异常阴影问题通常集中在以下几个方面问题现象可能原因解决方法完全没有阴影GetMainLight()没传阴影坐标改用GetMainLight(GetShadowCoord(positionWS))阴影边缘锯齿严重阴影贴图分辨率低在URP Asset里提高Shadow Resolution远处阴影消失阴影距离太短增大URP Asset里的Max Distance阴影区域过暗环境光在阴影区域贡献不足检查SampleSH是否被正确调用半透明物体阴影异常屏幕空间阴影不兼容关闭URP Asset里的Screen Space Shadows6.3 额外光源不生效或数量不对额外光源的问题通常和光源设置有关光源的Render Mode设成了Not Important这种光源不会被计入GetAdditionalLightsCount()只会作为顶点光源或者SH光源处理。把它改成Important或Auto。URP Asset里的Additional Lights设成了Disabled在URP Asset的Lighting面板里把Additional Lights设为Per Pixel。物体的Rendering Layer Mask排除了光源检查光源的Rendering Layer Mask和物体的Rendering Layer Mask是否有交集。循环上界写死了始终用GetAdditionalLightsCount()作为循环上界不要写死数字。6.4 环境光过亮或过暗环境光的问题通常和URP Asset的设置有关Intensity Multiplier被改过在URP Asset的Environment Lighting面板里检查这个值默认是1。SampleSH传入了错误的空间法线确保传入的是世界空间法线不是对象空间。环境光模式设置不当URP支持Skybox、Gradient、Color三种环境光模式不同模式下的球谐系数不同检查是否选对了模式。注意如果你在Shader里同时使用了SampleSH和自定义的环境光颜色可能会出现双重环境光叠加的问题。建议要么完全依赖SampleSH要么完全自定义不要混用。7. 管线迁移的实操建议与性能考量7.1 迁移前的准备工作在开始迁移Shader之前有几件事必须先做好第一确认URP版本和Unity版本匹配。不同版本的URP在API上有细微差异比如GetMainLight的参数在URP 10.x和12.x里就不完全一样。建议直接打开Package Manager查看当前URP版本的文档。第二备份所有自定义Shader。迁移过程中你可能会反复修改和回滚没有备份会非常痛苦。建议用Git或者直接复制一份到项目外的文件夹。第三建立一个测试场景。场景里放一个球体、一个平面、一个平行光、两个点光源用来验证光照、阴影、额外光源是否正常。这个场景在迁移过程中会反复用到。7.2 性能对比与优化建议URP的单Pass多光源架构在性能上通常优于内置管线的多Pass方案但也有一些需要注意的地方额外光源的循环开销虽然只有一个Pass但循环里每个光源都要计算完整的BRDF光源多了之后片元着色器的指令数会线性增长。建议在URP Asset里限制Additional Lights的最大数量比如设为4。阴影采样的开销URP的阴影采样比内置管线更统一但屏幕空间阴影在移动端可能有兼容性问题。如果目标平台是移动端建议关闭屏幕空间阴影。球谐环境光的开销SampleSH的计算量很小基本可以忽略。但如果你在片元着色器里多次调用建议把结果缓存到一个变量里。7.3 什么情况下值得迁移不是所有项目都需要从内置管线迁移到URP。如果你的项目满足以下条件迁移的收益会比较明显需要更好的移动端性能表现需要Shader Graph的可视化编辑能力需要统一的光照模型和后期处理栈项目还在早期没有大量依赖内置管线特性的自定义Shader但如果你的项目已经深度依赖内置管线的多Pass光照或者有大量手写的复杂光照Shader迁移的成本可能会很高。这种情况下可以考虑逐步迁移先把新场景和新材质用URP旧内容保持内置管线通过渲染管线切换来过渡。我个人在实际操作中的体会是URP的光照体系虽然一开始需要适应但一旦理解了Light结构体和Lighting.hlsl的设计思路写Shader反而比内置管线更简洁。你不需要再关心光源数量、Pass混合、衰减纹理采样这些底层细节可以把精力集中在材质表现本身。唯一需要警惕的是URP的版本迭代比较快API偶尔会有变动建议在升级URP版本时先跑一遍光照测试场景确认没有回归问题。
