1. 从Built-in到URP为什么我要重写这一章如果你手里正拿着一本《Unity Shader入门精要》翻到第5.2节看到那些基于Built-in渲染管线的表面着色器代码然后打开自己的Unity 2022 LTS项目发现根本跑不起来——恭喜你你不是一个人。我大概在去年下半年的时候把手上一个维护了三年多的Built-in项目迁移到URP原本以为只是改改材质、换换Shader的事结果发现书里第5章到第6章几乎一半的代码都需要重写。那种感觉就像你照着菜谱做菜结果发现菜谱是写给柴火灶的而你面前只有一个电磁炉。这篇文章就是把我踩过的坑、重新梳理的知识点、以及从5.2到6.0这个版本跨度中真正需要掌握的核心内容完整地分享出来。不管你是刚学完C#基础准备进军Shader的新手还是从Built-in时代过来的老手只要你的目标是搞懂URP下的Shader编写这篇内容都能帮你省下至少两周的试错时间。先说清楚一个前提我默认你已经知道Shader是什么、顶点片元着色器的基本流程、以及至少写过一两个能跑起来的简单Shader。如果你连SV_POSITION和SV_TARGET都还没见过建议先把第2章和第3章过一遍再回来。另外本文所有代码和测试环境基于Unity 2022.3 LTS URP 14.xHLSL作为主要着色语言不涉及Shader Graph的可视化操作——那东西虽然好用但理解底层HLSL才是你真正能掌控渲染效果的关键。2. 核心差异拆解Built-in和URP到底哪里不一样2.1 渲染管线的根本性变化很多人第一次接触URP的时候最直观的感受就是“以前的Shader不能用了”。但为什么不能用这个问题如果不搞清楚你后面写代码永远是照猫画虎。Built-in管线是一个“大而全”的固定流程。Unity在背后帮你处理了光照、阴影、反射、后处理等一大堆事情你写的表面着色器只需要声明一下#pragma surface surf Standard剩下的光照计算Unity自动帮你搞定。这就像你去一家套餐餐厅点一份“标准套餐”厨房把所有配菜都给你配好了。URP则完全不同。它把渲染流程拆成了一个个可配置的Pass光照计算需要你自己在Shader里显式处理。同样是套餐餐厅的比喻URP更像是自助餐——食材都摆在那里但你要自己搭配、自己烹饪。这种设计带来的好处是性能可控、效果可定制代价就是学习曲线陡增。具体到代码层面最核心的变化有这几个表面着色器Surface Shader不再支持。URP不支持#pragma surface指令你必须手写顶点着色器和片元着色器。内置变量和函数库变了。UnityCG.cginc变成了Core.hlsl_WorldSpaceCameraPos这类变量还在但UNITY_MATRIX_MVP这种宏已经换了写法。光照模式需要手动声明。Built-in里一个Tags {“LightMode”“ForwardBase”}就能搞定的事URP里需要配合UniversalForward和额外的Pass来处理阴影和附加光照。多Pass渲染策略不同。Built-in的前向渲染中一个Shader可以包含多个Pass分别处理基础光照和附加光照URP中虽然也支持多Pass但更推荐用单Pass前向渲染配合光照循环。2.2 从5.2到6.0的知识点映射书里的第5.2节主要讲的是表面着色器的基本写法包括属性定义、表面函数、光照函数这几个部分。到了第6章开始涉及更复杂的光照模型和自定义光照函数。这个知识结构在Built-in下是合理的但在URP下需要做一次彻底的“翻译”。我把这个映射关系整理成了一张表方便你对照着看Built-in5.2-6.0URP对应方案关键变化#pragma surface surf Standard手写顶点/片元着色器 UniversalForwardPass不再有自动光照Input结构体自定义Attributes和Varyings结构体语义名称变化surf函数顶点着色器中的属性赋值需要手动处理LightingStandardUniversalFragmentPBR函数函数库替换_WorldSpaceLightPos0_MainLightPosition变量名变化UNITY_LIGHT_ATTENUATIONGetMainLight()返回结构体阴影计算方式变化多Pass前向渲染单Pass 光照循环性能更优但写法不同这张表建议你截图保存每次写URP Shader卡住的时候拿出来看一眼能省很多查文档的时间。2.3 为什么URP要这样设计理解设计动机比记住API更重要。URP之所以放弃表面着色器核心原因是表面着色器本质上是一个“代码生成器”——Unity在编译时把你的表面函数展开成完整的顶点片元着色器。这个过程虽然方便但带来了两个问题一是编译时间长二是你无法精确控制生成的代码性能优化无从下手。URP选择把控制权交还给开发者。你需要自己写顶点着色器、自己调用光照函数、自己处理阴影。听起来麻烦但一旦你掌握了这套流程就能精确地知道每一行代码在GPU上做了什么。我在迁移项目的时候把原来的表面着色器重写成URP版本后Draw Call没变但GPU耗时降低了将近30%——原因就是去掉了表面着色器生成的那些冗余代码。3. URP Shader编写实操从零到能跑3.1 最小可运行Shader的结构先来看一个最基础的URP Shader长什么样。这个Shader不接受光照只是把一张贴图显示出来但它是你理解URP Shader结构的最佳起点。Shader Custom/URPBasic { Properties { _BaseMap (Base Texture, 2D) white {} _BaseColor (Base Color, Color) (1,1,1,1) } SubShader { Tags { RenderType Opaque RenderPipeline UniversalPipeline } Pass { Name ForwardLit Tags { LightMode UniversalForward } HLSLPROGRAM #pragma vertex vert #pragma fragment frag #include Packages/com.unity.render-pipelines.universal/ShaderLibrary/Core.hlsl struct Attributes { float4 positionOS : POSITION; float2 uv : TEXCOORD0; }; struct Varyings { float4 positionHCS : SV_POSITION; float2 uv : TEXCOORD0; }; TEXTURE2D(_BaseMap); SAMPLER(sampler_BaseMap); CBUFFER_START(UnityPerMaterial) float4 _BaseMap_ST; half4 _BaseColor; CBUFFER_END Varyings vert(Attributes IN) { Varyings OUT; OUT.positionHCS TransformObjectToHClip(IN.positionOS.xyz); OUT.uv TRANSFORM_TEX(IN.uv, _BaseMap); return OUT; } half4 frag(Varyings IN) : SV_Target { half4 texColor SAMPLE_TEXTURE2D(_BaseMap, sampler_BaseMap, IN.uv); return texColor * _BaseColor; } ENDHLSL } } }这段代码有几个关键点需要你特别注意。第一Tags里必须声明RenderPipeline UniversalPipeline否则URP不会识别这个Shader。第二CBUFFER_START(UnityPerMaterial)和CBUFFER_END包裹了所有材质属性这是SRP Batcher的要求——如果不这样写你的Shader就无法享受SRP Batcher带来的性能提升。第三纹理采样必须用TEXTURE2D和SAMPLER宏声明采样时用SAMPLE_TEXTURE2D这是跨平台兼容的写法。注意CBUFFER_START(UnityPerMaterial)里面只能放材质级别的属性不能放全局变量。如果你把_Time这种内置变量放进去编译会报错。3.2 加入光照从Unlit到PBR上面那个Shader虽然能跑但它不接收任何光照看起来就像一张贴纸。接下来我们要把它改造成能接收主光源、支持PBR材质的Shader。这是从5.2到6.0最核心的跨越。Shader Custom/URPLit { Properties { _BaseMap (Base Texture, 2D) white {} _BaseColor (Base Color, Color) (1,1,1,1) _Smoothness (Smoothness, Range(0,1)) 0.5 _Metallic (Metallic, Range(0,1)) 0.0 } SubShader { Tags { RenderType Opaque RenderPipeline UniversalPipeline } Pass { Name ForwardLit Tags { LightMode UniversalForward } HLSLPROGRAM #pragma vertex vert #pragma fragment frag #pragma multi_compile _ _MAIN_LIGHT_SHADOWS #pragma multi_compile _ _MAIN_LIGHT_SHADOWS_CASCADE #pragma multi_compile _ _SHADOWS_SOFT #include Packages/com.unity.render-pipelines.universal/ShaderLibrary/Core.hlsl #include Packages/com.unity.render-pipelines.universal/ShaderLibrary/Lighting.hlsl struct Attributes { float4 positionOS : POSITION; float3 normalOS : NORMAL; float2 uv : TEXCOORD0; }; struct Varyings { float4 positionHCS : SV_POSITION; float2 uv : TEXCOORD0; float3 positionWS : TEXCOORD1; float3 normalWS : TEXCOORD2; }; TEXTURE2D(_BaseMap); SAMPLER(sampler_BaseMap); CBUFFER_START(UnityPerMaterial) float4 _BaseMap_ST; half4 _BaseColor; half _Smoothness; half _Metallic; CBUFFER_END Varyings vert(Attributes IN) { Varyings OUT; VertexPositionInputs posInputs GetVertexPositionInputs(IN.positionOS.xyz); VertexNormalInputs normInputs GetVertexNormalInputs(IN.normalOS); OUT.positionHCS posInputs.positionCS; OUT.positionWS posInputs.positionWS; OUT.normalWS normInputs.normalWS; OUT.uv TRANSFORM_TEX(IN.uv, _BaseMap); return OUT; } half4 frag(Varyings IN) : SV_Target { half4 texColor SAMPLE_TEXTURE2D(_BaseMap, sampler_BaseMap, IN.uv); half3 albedo texColor.rgb * _BaseColor.rgb; half3 normalWS normalize(IN.normalWS); SurfaceData surfaceData (SurfaceData)0; surfaceData.albedo albedo; surfaceData.metallic _Metallic; surfaceData.smoothness _Smoothness; surfaceData.normalTS half3(0, 0, 1); surfaceData.occlusion 1; surfaceData.alpha 1; InputData inputData (InputData)0; inputData.positionWS IN.positionWS; inputData.normalWS normalWS; inputData.viewDirectionWS GetWorldSpaceNormalizeViewDir(IN.positionWS); inputData.shadowCoord TransformWorldToShadowCoord(IN.positionWS); half4 color UniversalFragmentPBR(inputData, surfaceData); return color; } ENDHLSL } Pass { Name ShadowCaster Tags { LightMode ShadowCaster } HLSLPROGRAM #pragma vertex ShadowPassVertex #pragma fragment ShadowPassFragment #include Packages/com.unity.render-pipelines.universal/ShaderLibrary/Core.hlsl #include Packages/com.unity.render-pipelines.universal/ShaderLibrary/Shadows.hlsl float3 _LightDirection; struct Attributes { float4 positionOS : POSITION; float3 normalOS : NORMAL; }; struct Varyings { float4 positionCS : SV_POSITION; }; Varyings ShadowPassVertex(Attributes IN) { Varyings OUT; float3 positionWS TransformObjectToWorld(IN.positionOS.xyz); float3 normalWS TransformObjectToWorldNormal(IN.normalOS); float4 positionCS TransformWorldToHClip( ApplyShadowBias(positionWS, normalWS, _LightDirection) ); OUT.positionCS positionCS; return OUT; } half4 ShadowPassFragment(Varyings IN) : SV_Target { return 0; } ENDHLSL } } }这个Shader已经具备了完整的PBR光照和阴影投射能力。我重点解释几个容易出错的地方。GetVertexPositionInputs和GetVertexNormalInputs是URP提供的工具函数它们一次性帮你算好了世界空间位置、裁剪空间位置、世界空间法线等数据。你不需要再手动乘各种矩阵这也是URP比Built-in写起来更简洁的地方之一。SurfaceData和InputData是两个结构体前者描述材质表面属性反照率、金属度、光滑度等后者描述光照计算需要的输入位置、法线、视线方向、阴影坐标等。UniversalFragmentPBR函数接收这两个结构体返回最终颜色。这套流程替代了Built-in里的LightingStandard函数。阴影投射的Pass是必须的否则你的物体不会向其他物体投射阴影。这个Pass的写法相对固定直接复制上面的代码即可唯一需要注意的是_LightDirection变量——它由URP在渲染阴影贴图时自动赋值。3.3 多光源和附加光照的处理上面的Shader只处理了主光源。如果你场景里有多个光源需要额外处理附加光照。在Built-in中这通常通过多Pass实现在URP中推荐在同一个Pass里用光照循环处理。// 在frag函数中UniversalFragmentPBR之后 uint pixelLightCount GetAdditionalLightsCount(); for (uint lightIndex 0; lightIndex pixelLightCount; lightIndex) { Light light GetAdditionalLight(lightIndex, IN.positionWS); // 手动累加光照贡献 half3 lightColor light.color * light.distanceAttenuation; half NdotL saturate(dot(normalWS, light.direction)); color.rgb albedo * lightColor * NdotL; }不过说实话UniversalFragmentPBR内部已经处理了附加光照你不需要手动写这个循环。我把它列出来是为了让你理解原理——当你需要自定义光照模型的时候这个循环就是你的起点。实操心得如果你发现场景里附加光源没有效果先检查URP Asset里的Additional Lights设置。默认情况下URP可能把附加光源设为Disabled或者Per Vertex需要改成Per Pixel才能看到效果。4. 常见问题与排查技巧实录4.1 Shader编译报错速查从Built-in迁移到URP的过程中你大概率会遇到下面这些报错。我把它们整理成了速查表报错信息原因解决方法UnityCG.cginc file not found引用了Built-in的库文件改为Core.hlsl和Lighting.hlslShader error: surface is not a valid directive使用了表面着色器改写为顶点片元着色器undeclared identifier UNITY_MATRIX_MVP使用了Built-in宏改用TransformObjectToHCliptex2D is not a valid function使用了旧版纹理采样改用SAMPLE_TEXTURE2DShader is not SRP Batcher compatible材质属性未放入CBUFFER用CBUFFER_START(UnityPerMaterial)包裹LightingStandard undefined引用了Built-in光照函数改用UniversalFragmentPBR这张表建议你放在手边遇到报错先查表90%的问题都能快速定位。4.2 渲染效果不对的排查思路Shader能编译通过不代表效果正确。下面这些是我实际项目中遇到过的典型问题。问题一模型全黑或者全白。全黑通常是因为法线方向反了检查normalWS是否需要取反。全白则可能是光照强度过高或者SurfaceData没有正确初始化。我习惯在frag函数最后直接return half4(normalWS * 0.5 0.5, 1)来可视化法线确认法线是否正确。问题二阴影出现条纹或者偏移。这是阴影偏移Shadow Bias的问题。URP的阴影Pass中ApplyShadowBias函数负责处理偏移。如果条纹严重可以在URP Asset里调整Shadow Bias和Shadow Normal Bias参数。我一般把Bias设为0.05Normal Bias设为0.4大部分场景下效果都不错。问题三SRP Batcher没有生效。打开Frame Debugger如果看到SRP Batch的数值是0说明SRP Batcher没有工作。检查两个地方一是所有材质属性是否都在CBUFFER_START(UnityPerMaterial)里二是Shader中是否使用了UnityPerMaterial之外的材质级变量。问题四移动端上效果和编辑器不一致。这通常是精度问题。half在移动端GPU上是16位浮点精度远低于桌面端的32位。如果你的Shader在编辑器里正常但手机上出现色带或者计算错误把所有half改成float试试。确认没问题后再逐步改回half来优化性能。4.3 性能优化的几个实用技巧写URP Shader的时候性能优化不是可选项而是必选项。下面这几个技巧是我在实际项目中验证有效的。第一能不用float就不用float。颜色、UV、法线这些数据用half就够了只有世界空间位置和需要高精度的计算才用float。在移动端这个习惯能帮你省下可观的带宽。第二避免在片元着色器里做顶点着色器能做的事。比如世界空间位置的计算放在顶点着色器里算好传给片元着色器比在片元着色器里重新算要高效得多。第三合理使用#pragma multi_compile和#pragma shader_feature。multi_compile会生成所有变体shader_feature只生成材质实际用到的变体。对于阴影开关这种运行时可能切换的功能用multi_compile对于材质级别的开关用shader_feature。第四纹理采样尽量合并。如果你需要采样多张纹理考虑用通道打包Channel Packing把多张灰度图打包到一张RGBA纹理的不同通道里一次采样获取四个值。注意通道打包虽然能减少采样次数但会增加美术的工作量。在项目早期就要和美术沟通好打包规范否则后期返工成本很高。5. 从能跑到好用进阶方向建议5.1 掌握Shader Variant管理当你写了十几个Shader之后Variant数量会爆炸式增长。一个包含5个multi_compile开关的Shader理论上会产生32个变体。如果项目里有几十个这样的Shader编译时间和包体大小都会失控。我的做法是在URP Asset里开启Shader Variant Log定期检查哪些变体是实际用到的哪些是冗余的。然后通过IPreprocessShaders接口在构建时剔除不需要的变体。这个接口需要写Editor脚本但一次投入长期受益。5.2 学会用Frame Debugger和RenderDoc编辑器自带的Frame Debugger能帮你看到每一个Draw Call对应的Shader和Pass是排查渲染问题的第一工具。RenderDoc则能深入到GPU层面看到每一个像素的着色过程。这两个工具配合使用基本上没有定位不了的渲染问题。我刚开始学Shader的时候遇到效果不对就靠猜改一行跑一次效率极低。后来养成用Frame Debugger的习惯后排查时间从平均半小时缩短到五分钟以内。5.3 建立自己的Shader模板库从5.2到6.0这个过程中我最大的收获不是学会了某个具体的Shader写法而是建立了一套自己的模板库。Unlit模板、PBR模板、带阴影的模板、带附加光照的模板、后处理模板——每个模板都经过项目验证需要的时候直接复制修改效率比从头写高得多。这个模板库不需要多复杂关键是每个模板都要有清晰的注释说明哪些地方需要根据具体需求修改。比如PBR模板里我会标注“如果需要法线贴图在这里添加_NormalMap采样和切线空间转换”。5.4 关注URP的版本更新URP的API在版本之间会有变化。比如从URP 12到URP 14GetMainLight函数的参数就变过。我的建议是锁定一个LTS版本不要频繁升级。如果必须升级先在一个独立分支上测试所有Shader确认没问题再合并到主分支。另外Unity的官方文档和URP的源码是你最好的参考资料。遇到不确定的API直接去翻Packages/com.unity.render-pipelines.universal/ShaderLibrary/目录下的源码比在网上搜半天答案靠谱得多。我个人在实际操作中的体会是从Built-in到URP的迁移表面上是API的变化本质上是思维方式的转变——从“让Unity帮我做”变成“我自己控制每一步”。这个转变过程确实痛苦但一旦跨过去你对渲染的理解会上升一个台阶。后面如果再遇到管线升级或者自定义渲染需求你会有足够的底气去应对。