知知呼呼在UE5里给角色或物件加描边，不少人第一反应就是上后处理，用自定义深度通道做边缘检测。这套方案对不透明物体非常好用，但一旦换成半透明材质，比如能量罩、传送门、幽灵虚影、玻璃瓶身，你会发现同一个后处理完全失效，描边像凭空消失一样。我一开始也卡在这，反复检查材质节点和后处理体积都没问题，最后翻了源码和论坛才明白根因：半透明物体压根不会被写进自定义深度通道，你没让它“存在”在描边的依据里，效果当然出不来。
这篇文章就围绕这个点展开，把原理、官方解法、备用方案和踩坑经验完整讲透。不管你是做风格化渲染、科幻特效，还是想给特定物体做高亮描边，都可以照着做。
1. 先搞清楚：自定义深度通道为什么“看不见”半透明物体
1.1 UE5渲染管线的Pass顺序
要理解这个问题，先得知道UE5渲染一帧时，各阶段大致是这样走的：
- 深度预 pass（PrePass / Depth Only）：只写深度，为后续剔除和降噪服务。
- 基础 pass（BasePass）：渲染不透明和遮罩物体，写入GBuffer，包含颜色、法线、粗糙度等。
- 阴影 pass（Shadow Pass）：生成阴影贴图。
- 半透明 pass（Translucency Pass）：渲染Blend Mode为Translucent的物体，不写GBuffer深度。
- 后处理（PostProcess）：全屏处理，NDC颜色调整、Bloom、描边等都在这时候做。
描边用的CustomDepth，其实是一份独立于主场景深度的额外缓冲。引擎在BasePass前后，会再额外跑一次“自定义深度渲染”，但这次渲染只处理那些勾选了 Render Custom Depth Pass 的物体。
问题就出在：默认情况下，这个自定义深度渲染列表里没有半透明物体。半透明物体走的是独立的Translucency Pass，而CustomDepth pass在筛选渲染对象时，压根不把它们算进去。
1.2 半透明材质为什么不写CustomDepth
从材质Blend Mode的角度看，UE5里半透明不使用Opaque那套渲染状态。它不写入主深度缓冲，也不需要光照响应，渲染时按从后往前的顺序排序，用于做玻璃、烟雾、能量场这类效果。
CustomDepth这一层，设计时主要就是给不透明物体当“后处理标记位”用的。官方文档里也写得很明确：CustomDepth和CustomStencil默认只作用于不透明几何体。哪怕你手动把MeshComponent的Render Custom Depth Pass打开，如果材质本身是Translucent、且没有单独声明允许写入自定义深度，渲染器依然会跳过它。
所以整个逻辑链是这样的：
- 描边需要边缘数据，边缘数据来自CustomDepth或CustomStencil。
- CustomDepth渲染列表里没有半透明物体。
- 半透明物体的颜色最终合成到屏幕，但没有任何一个缓冲记录它的“轮廓位置信息”。
- 后处理描边自然无从谈起。
我用一个生活化类比：你要在照片里找一个人的背影，但那个人根本没有站进拍照区域，只是在旁边拿投影仪投了个虚影。相机拍不到他的实体，你怎么后期描边都描不中。半透明物体就是这样，它只投了个“视觉虚影”到屏幕上，CustomDepth这张“名单”上没它名字。
1.3 CustomStencil也没用吗
有些朋友想着，深度不行，那我用模板Stencil总行吧？CustomStencil默认也一样，只对勾选并且被CustomDepth pass接收的物体写入。半透明物体同样进不了这个pass，所以Stencil值写了也没人理。
这个认知非常重要。很多新手在材质里给半透明物体设置CustomStencil值，然后在后处理里读，结果读出来全是0，就是因为根本没进入写入阶段。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 方案的底层逻辑：两条路，目标都是“让描边有据可依”
既然问题的本质是“透明物体没有写入CustomDepth”，那么解决方案无非两条路：
2.1 思路A：让半透明物体本身也能写入CustomDepth
这个思路最直观，就是给材质一个特殊权限，允许它被CustomDepth pass收录。UE5里入口就是我们常说的 Allow Custom Depth Writes，这是官方专门为半透明物体开的口子。勾上之后，半透明物体会被额外渲染一次到CustomDepth，后处理描边就能识别到它了。
这个方案优点是干净、直接、不用额外维护一个替身物体；缺点是需要改动原始材质，如果项目里半透明材质特别多，可能得逐个加开关，而且要注意和项目里的SRP/渲染路径兼容性。
2.2 思路B：用不透明替身物体去写CustomDepth
如果不方便改原材质，或者模型是外部导入、材质不可控，那么可以复制一份相同的网格体，放到原物体位置，再把材质的Blend Mode改成Opaque，同时让它只渲染到CustomDepth、不显示在主场景。这样CustomDepth里就有了它的轮廓，后处理描边照常工作。
这个方案的好处是完全不影响原材质和半透明渲染逻辑；缺点是需要处理动画同步、位置同步、DrawCall翻倍，维护成本高一点。
两条路我都在项目里试过，可以负责任地说：优先方案A，只有改不了材质时才用方案B。
3. 方案一实操：Allow Custom Depth Writes 让透明材质“入镜”
3.1 材质侧设置：打开自定义深度写入开关
操作步骤很简单，但位置容易被忽略。
打开半透明材质编辑器，在左侧 Details 面板里搜索 Custom Depth，会看到一个 Allow Custom Depth Writes 选项。勾选它，然后保存材质。
这里有个小细节：你搜索的关键词可以试试“CustomDepth”或“Allow Custom”，因为不同UE5小版本里的命名略有差异。在UE5.0到5.3里，这个选项都在Advanced分类下，英文全称是 Allow Custom Depth Writes。
勾选后，理论上这个材质就有了“被CustomDepth pass渲染”的资格。但要注意，仅仅勾材质还不够，因为引擎还是需要知道哪些Actor要写、用什么标记值区分。
3.2 组件侧设置：开启Render Custom Depth Pass并设置Stencil
现在回到关卡或蓝图里，选中那个使用半透明材质的物体，在右侧细节面板找到 Rendering 分类：
- 勾选 Render Custom Depth Pass
- 把 Custom Depth Stencil Value 设置为1
这个Stencil值就是给后处理描边用的“身份标签”。如果场景里有多个半透明物体，你可以分配不同的Stencil值，这样后处理可以只描其中某一个，或者只描某一类。比如能量罩用1，传送门用2，后处理里按值过滤，互不干扰。
很多人在这一步省事，不勾Render Custom Depth Pass，结果发现材质开关开了也没效果。记住，材质开关和组件开关是“与”的关系，两个都必须打开。
3.3 后处理描边材质实现
接下来是核心部分：后处理材质怎么连，才能把半透明物体的边描出来。
我推荐用Stencil判断，而不是直接用深度差。原因有两个：一是Stencil是整数，边缘判断非常干净，不会出现远处深度精度不够的问题；二是可以按标记值精确过滤，只描目标物体。
创建一个新的Material，设置如下：
- Material Domain：Post Process
- Blendable Location：After Tonemapping
- Output：最终用Lerp把描边颜色混进画面
节点流程是这样的：
- 用 SceneTexture 节点，SceneTexture Id选 CustomStencil，从RGB通道里拿到当前像素的Stencil值。
- 用 PixelSize 节点拿到屏幕像素大小，这个值等于1/屏幕分辨率，方便我们做相邻像素偏移。
- 用 ViewportUV 节点获取当前UV坐标，然后分别加/减PixelSize的偏移，采样上下左右四个邻居的Stencil值。
- 计算边缘Mask：
Mask = abs(Center - Left) + abs(Center - Right) + abs(Center - Up) + abs(Center - Down)- 值为0说明周围和中心一致，说明不是边缘；值大于0说明这里有Stencil跳变，就是边缘。
- 用 SmoothStep 或者 Step 节点把Mask做一次阈值处理，防止边缘抖动。
- 最终颜色输出：
FinalColor = Lerp(PostProcessInput0, OutlineColor, EdgeMask)- 这样描边只影响边缘像素，其他区域原样输出。
实操里有个容易踩的坑：SceneTexture节点默认输出可能是基于sRGB的，但CustomStencil不是颜色信息，别去勾sRGB选项，保持线性读取，否则判断阈值会不准。
还有一个技巧，很多教程只采样上下左右四方向，实际效果有锯齿。我建议再加上对角线的偏移量，形成8方向采样。就是上左、上右、下左、下右也各采一次，边缘Mask会平滑很多。代价是采样次数从5次变成9次，但对现代GPU来说几乎无所谓。
3.4 阈值和颜色调优参数设计
我在实际项目里习惯把这几个参数暴露成PostProcess Material的Custom参数，方便策划同事直接在材质实例里调：
- OutlineColor：描边颜色，比如纯黑色（0,0,0）或风格化的白色。
- OutlineIntensity：描边强度，我一般用Lerp的Alpha乘以这个值。
- Thickeness：描边粗细，实现方法就是多采样几圈，每圈偏移量乘以一个放大系数。
- Threshold：模板差异阈值，一般用0.01到0.1之间，Stencil模式不太需要调，但保留一个参数应付特殊情况。
这套参数化设计的好处是，不用每次改材质图，直接调材质实例参数就能看效果。
4. 方案二实操：不透明替身网格体方案
4.1 什么场景下必须用替身
官方这个Allow Custom Depth Writes开关很好用，但有一些情况确实用不上：
- 半透明材质是从外部拿来的，工程里不允许改动。
- 材质是动态生成的，或者公共资源被大量引用，动了会影响其他物件。
- 项目渲染路径有特殊限制，导致勾选后半透明组合异常。
这时候我就用替身方案，在场景里放一个和原物体形状完全一样、但只写CustomDepth的“影子”。
4.2 替身物体具体设置步骤
我把一个静态网格体力场护盾的替身制作过程拆给你看：
- 复制一份原物体，比如把StaticMeshComponent用变量保存引用，运行时Spawn一个同网格体Actor。
- 把替身Actor或者Component的位置、旋转、缩放设置成和原物体完全一致。如果是在编辑器里手动放置，就直接Attach到原物体下面，Relative Transform全部归零。
- 给替身添加一个普通不透明材质，随便用Pure Color节点输出纯黑色就行，因为我们不需要它在画面里显示。
- 在替身组件的Rendering设置里：
- 关闭 Visible（或者勾选 Primary 相关选项让它不出现在主渲染中，但我测试下来最稳的就是直接Visible关掉）
- 关闭 Cast Shadow
- 勾选 Render Custom Depth Pass
- 设置 Custom Depth Stencil Value 为1
- 确认替身的材质没有开启双面渲染，免得深度信息错乱。
这个方案下，替身虽然不可见，但CustomDepth pass依然会把它渲染进缓冲区。后处理描边得到的轮廓和原物体完全重合。
4.3 骨骼网格与动画同步问题
如果目标物体是SkeletalMesh，比如一个半透明的幽灵角色，替身方案就要处理动画同步。
最省事的做法是：把替身SkeletalMeshComponent的 Master Pose Component 指向原始SkeletalMeshComponent。这样替身每次都会沿用原骨骼的Pose，不需要手动每帧拷贝骨骼矩阵。如果用了ControlRig或Masked动画，需要确认两个组件用的动画蓝图是同一个。
如果是代码驱动骨骼，比如手动修改Bone Transform，那么就得在Tick里手动同步。这个成本比较高，所以我的建议是：能改材质就优先方案A，别给自己找麻烦。
4.4 与方案一的对比总结
用一张表格直观对比：
| 对比项 | 方案A：Allow Custom Depth Writes | 方案B：替身网格体 |
|---|---|---|
| 材质改动 | 需要 | 不需要 |
| 组件改动 | 只需勾选两项 | 需要新增组件/物体 |
| 动画同步 | 不需要额外处理 | 骨骼网格需要同步Pose |
| 性能开销 | 每次多渲染一次该物体到CustomDepth | 多一个替身物体的CustomDepth渲染，略高 |
| 适用场景 | 大部分半透明物件 | 材质不可改、快速原型 |
| 维护成本 | 低 | 中高 |
我自己在实际项目里绝大多数情况都用方案A，替身方案只在遇到外部插件材质、不便修改时才启用。
5. 常见问题与调优实录
5.1 勾了所有开关，描边还是出不来
这是论坛里问得最多的。我从头到尾排查的顺序是固定的，你照着来：
- 确认后处理材质已经正确加到PostProcessVolume的Post Process Materials数组里。
- 确认材质Domain是Post Process，而不是Surface。
- 确认目标物体的Mesh Component勾了Render Custom Depth Pass。
- 确认材质勾了Allow Custom Depth Writes，并且编译成功。
- 在后处理材质里临时输出一个纯色，比如直接输出 (1,0,0)，看画面有没有红色。如果有红色，说明后处理链路是通的，问题出在Stencil或深度采样上。
- 打开场景里的Visualize Custom Depth视图模式，直接看有没有白模显示。这个模式能直观告诉你CustomDepth到底有哪些物体被渲染了。
我遇到过好几次“勾了却没效果”，原因都是忘了保存材质，或者蓝图里Spawn的物体没有设置Render CustomDepth，只改了关卡里放着的旧Actor。
5.2 描边边缘锯齿严重、断断续续
边缘锯齿多半是采样方向不够多造成的，至少加上对角线采样。还有一个因素是Stencil值跳变时，边缘像素没有做平滑，直接用Step进行二值化会放大锯齿。
我的应对办法：
- 使用8方向采样。
- 对Mask做一次3x3范围内的小范围模糊，或者直接使用SmoothStep(0.01, 0.3, Mask)过渡。
- 在后处理材质里把输出前的EdgeMask做一次Clamp，避免过冲。
实话说，描边这件事，大部分时候是“边缘提取不够干净”，不是程序有问题。把采样做足、阈值给梯度，锯齿基本能压下去。
5.3 半透明物体之间互相遮挡时描边错乱
半透明物体本身不写深度，它们之间的前后关系是靠排序决定的。当两个半透明物体叠加时，CustomDepth里只记录各自的深度，没有半透明混合之后的前后关系。如果你同时给两个不同Stencil值的半透明物体描边，很可能出现后描的边盖住了前描的边。
我的建议是：
- 尽量只对一层半透明物体描边，需要多层的就分组管理。
- 如果必须多层，就给更靠近相机的物体设置更高优先级的Stencil过滤，或者用Custom Deep值做距离比较。
- 如果只是视觉上的“描边被透明遮挡”，可以把描边输出安排到After Tonemapping之后，让它始终显示在最上层。
5.4 性能开销有多大
一次CustomDepth pass意味着场景里所有勾了Render Custom Depth Pass的物体被额外渲染一次，数量越多开销越大。但绝大多数情况场景里需要描边的物体就那么几个，DrawCall增量很小。
后处理描边材质的开销主要是全屏采样。9次纹理采样加上基础输出，在1080P下一般占0.2ms左右，不同显卡有差异。为了性能，我有时会把描边的后处理放到半分辨率去做，然后再上采样合成，视觉效果几乎一样，性能能省一半。
5.5 粒子/特效的透明材质怎么描边
Niagara粒子并不属于StaticMesh或SkeletalMesh组件，没有Render Custom Depth Pass这个开关。所以上面的方案都不适用于粒子。
如果你确实要给Niagara粒子描边，思路要换一下：要么把粒子渲染成自定义深度，要么在材质里用菲涅尔做假描边。我用得比较多的是后者，比如给能量粒子的材质加一个Fresnel节点并叠加到Emissive，视觉上接近描边轮廓，但实现方式完全是另一套逻辑，就不在这篇展开了。
6. 几个让效果更“高级”的小技巧
除了基本描边，这套CustomDepth方案还能玩出很多花活。我把自己用过并且觉得实用的几个点列出来。
6.1 只描特定标记值的物体
后处理里判断Stencil时，不只要找边缘，还要检查当前像素的Stencil是否为指定值。方法很粗暴：用等于目标值的比较节点生成一个Mask，再和边缘Mask相乘。这样场景里其他写入了CustomDepth但Stencil值不同的物体，就不会被误描。
我做过一个效果：同一个场景里，能量罩用Stencil 1描一次白边，传送门用Stencil 2描一次蓝边。后处理材质复用同一个模板，两个材质实例分别配置目标Stencil值和描边颜色，效率很高。
6.2 描边宽度自适应
镜头拉近拉远时，固定像素偏移的描边会显得忽粗忽细。可以结合一个简单的距离参数修正宽度偏移量。
比如把Custom Depth的深度值读出来，用线性化深度乘一个系数，再加到偏移量的Scale上。这样近处描边像素偏移小一点，远处偏移大一点，整体视觉粗细稳定。这个调优对第三人称游戏特别有用，人物离镜头近时描边不至于糊一整片。
6.3 让描边带有动态效果
如果你做的是科幻题材，能量罩的描边可以随Time节点流动。我的做法是：在最终的OutlineColor里加一个Time驱动的UV扰动，只对Mask区域生效。描边本身保持硬边，颜色在边缘处做一点波纹渐变，看起来就像能量在流动。
另一个更简单的方式是直接把描边颜色用Noise节点扰动，配合SmoothStep做闪烁。这些效果本质上都是在Mask之上叠风格化颜色，基础链路完全没变。
6.4 移动端怎么跑
移动端对后处理SceneTexture采样限制比较多，尤其是部分旧设备不支持在PostProcess里读取CustomStencil。我在移动端项目里会做一层降级：不启用描边后处理，而是在材质里用菲涅尔加自发光模拟边缘高光，至少保证视觉上物体轮廓是清楚的。这么做虽然不如后处理描边精准，但胜在兼容性好、不掉帧。
如果你必须跑后处理描边，建议用OpenGL ES 3.1以上的设备，并且不要用太多依赖ViewportUV的高频采样，极端情况下可以缩减到4方向采样。
7. 最后分享一点实际项目中的体会
我后来做了一个科技向的交互演示，里面用到大量半透明虚拟屏幕和能量护盾。描边这东西一开始被我当成纯美术需求，结果落地时发现全卡在“透明材质不进CustomDepth”这个渲染机制上。等你理解了整个Pass链路，你会发现绝大部分描边问题都能归因到“目标物到底有没有被写入某个缓冲”。只要它写了，后处理就永远有办法把边缘抓出来。
另外一个小建议：做描边之前，先在项目设置里打开CustomDepth相关的Visualize视图，把场景里哪些物体写入了CustomDepth看得明明白白，再动手调材质。这一步能帮你省掉非常多无意义的排查时间。
希望这篇长文能帮你少踩几个坑。如果你手头正好在做半透明描边，先试方案A，开关加材质，10分钟就能看到效果；搞不定再回来试替身方案，虽然笨一点，但总归是个能落地的兜底手段。