1. 项目概述Runtime Editor 选中高亮的本质与痛点在 Unity 编辑器里开发时我们最习以为常的一个功能就是点击场景中的物体它会立刻被一个亮色的线框Outline包裹起来清晰无比地告诉我们“你选中了这个”。这个功能我们称之为“编辑器选中高亮”。然而一旦我们按下播放键进入运行模式Runtime这个贴心的“高亮”功能就消失了。很多开发者尤其是需要制作运行时关卡编辑器、可视化配置工具或者拥有复杂交互逻辑的开发者都迫切需要在游戏运行时也能实现这种清晰、直观的选中反馈。你遇到的“Outline Manager 为 Missing”错误正是试图在运行时复现这一功能时一个非常典型且令人头疼的拦路虎。这个错误通常意味着你项目中某个负责处理高亮渲染的脚本组件Outline Manager或其依赖的资源在构建Build后或某些特定条件下丢失了。这不仅仅是资源引用断裂那么简单更深层的原因往往与 Unity 不同的渲染管线Built-in、URP、HDRP对渲染流程的控制差异、以及编辑器专用功能在运行时的不可用性有关。本文将彻底拆解这个问题从原理到实操为你提供一个稳定、跨管线的运行时选中高亮解决方案并根治“Missing”这个顽疾。2. 核心原理Unity 编辑器高亮与运行时实现的鸿沟2.1 编辑器高亮是如何工作的Unity 编辑器的选中高亮并非通过给物体附加一个普通的材质球来实现。它是一种基于“渲染队列插队”的后处理技术。简单来说当你在编辑器中选择一个物体时额外渲染通道Unity 会为这个被选中的物体在正常的渲染流程之外额外安排一次渲染。特定着色器这次渲染使用一个特殊的、仅绘制物体边缘的着色器Shader。命令缓冲Command Buffer这个“额外渲染”的指令是通过一个叫做CommandBuffer的东西注入到摄像机的渲染流程中的。CommandBuffer允许你在 Unity 固有的渲染步骤之间插入自定义的绘制命令。屏幕空间合成最终这个只渲染了边缘的图案会以屏幕后处理的方式叠加到我们最终看到的游戏画面上形成高亮轮廓。关键在于这套流程严重依赖编辑器内部 API如EditorGUIUtility.Load加载特定着色器UnityEditor.Handles相关类进行绘制这些 API 在游戏打包后是完全不存在的。直接调用会导致编译错误或运行时失效。这就是为什么你不能简单地把编辑器功能搬到运行时。2.2 “Outline Manager Missing” 错误的根源当你从 Asset Store 下载或从 GitHub 找到一些运行时高亮插件例如搜索“Runtime Outline”会找到很多时它们通常会提供一个叫Outline或OutlineManager的脚本。这个错误的发生主要有以下几个场景脚本编译错误导致丢失如果OutlineManager脚本本身有语法错误或者它引用了其他不存在的类/APIUnity 在编译时会失败。在 Project 视图中该脚本会变成一个“Missing”状态。任何挂载了该脚本的 GameObject在 Inspector 里都会显示脚本为 “Missing (Mono Script)”。预制体Prefab或场景引用丢失OutlineManager脚本可能被正确编译但它内部可能通过public GameObject字段或[SerializeField]私有字段引用了另一个 GameObject、材质Material或着色器Shader。如果这些被引用的资源被移动、重命名或删除那么 Unity 就无法找到它在 Inspector 中该引用字段会显示为 “None”并且可能在某些插件逻辑中抛出“Missing”相关的错误。渲染管线不兼容这是最隐蔽也最常见的原因。许多早期的轮廓高亮插件是为 Unity 内置渲染管线Built-in RP编写的。它们使用Camera.onPreRender事件和针对内置管线的CommandBuffer命令。当你将项目切换到 URP通用渲染管线或 HDRP高清渲染管线时原有的渲染流程和着色器完全变了。插件脚本可能因为调用了不存在的 API如Graphics.ExecuteCommandBuffer的某些重载而无法编译或者编译后因为着色器不兼容而完全不起作用在运行时表现为功能缺失被误认为是“Manager Missing”。程序集引用问题如果OutlineManager脚本被放置在一个特殊的程序集定义Assembly Definition文件中而这个程序集未能正确引用 Unity 必要的模块如UnityEngine.Rendering也可能导致脚本无法被正确识别。注意区分“脚本组件丢失”和“功能失效”很重要。Inspector 里显示“Missing (Mono Script)”是第一种情况。而脚本存在但轮廓不显示是第二种或第三种情况。本文会一并解决。3. 解决方案选型构建健壮的运行时高亮系统鉴于直接使用编辑器方案不可行且第三方插件易出现兼容性问题我推荐采用一种更可控、更现代的实现方式。其核心思路是利用当前渲染管线URP/HDRP提供的可编程渲染能力实现一个不依赖特定插件、资源绑定稳固的高亮系统。3.1 方案对比传统插件 vs 自定义渲染方案特性传统第三方插件自定义渲染方案本文推荐稳定性依赖作者维护易因Unity版本更新而失效基于官方管线API生命周期与管线一致可定制性通常有限修改需要理解插件内部结构完全自主控制可调整颜色、宽度、闪烁等所有效果跨管线支持通常只支持一种管线切换后需寻找新插件一套逻辑通过条件编译适配不同管线“Missing”风险高。资源引用复杂易丢失。低。核心代码即脚本材质可动态生成或严格管理。学习成本低即插即用在它正常工作时中高需要理解渲染基本概念长期收益解决一时之需掌握一项核心图形技术一劳永逸3.2 技术路径选择URP/HDRP 的 Renderer Feature 与 Custom Pass对于现代 Unity 项目URP 和 HDRP 是更推荐的选择。它们提供了优雅的扩展点对于 URP使用ScriptableRendererFeature和ScriptableRenderPass。你可以在 URP 渲染器的某个阶段如渲染不透明物体之后插入一个自定义的 Pass专门用来绘制我们选中的物体的轮廓。对于 HDRP使用CustomPass。HDRP 直接提供了 Custom Pass 框架可以在体积Volume中配置在指定的注入点如透明物体渲染前执行轮廓绘制。这两种方式本质相同将轮廓绘制逻辑整合进官方渲染流程避免了手动管理CommandBuffer的繁琐和兼容性问题资源材质、着色器可以直接作为 Feature 或 Pass 的字段进行序列化极大降低了引用丢失的风险。4. 实战为 URP 实现一个零“Missing”风险的运行时高亮下面我们以 URP 为例手把手创建一个绝不会出现“Missing”问题的运行时高亮系统。HDRP 的思路完全一致只是 API 换成了CustomPass。4.1 第一步创建轮廓着色器首先我们需要一个专门用来画轮廓的着色器。在 Project 窗口右键Create Shader Unlit Shader命名为OutlineShader。用以下代码完全替换其内容Shader Hidden/Outline { Properties { _OutlineColor (Outline Color, Color) (1, 0.5, 0, 1) _OutlineWidth (Outline Width, Range(0, 10)) 2.0 } SubShader { Tags { RenderTypeOpaque RenderPipelineUniversalPipeline QueueGeometry1 } // 第一个Pass正常渲染物体到轮廓用的缓冲区这里我们直接用它的深度和法线 // 实际上我们通常不需要自己渲染而是利用URP已有的深度和法线纹理。 // 所以这个SubShader主要服务于第二个Pass屏幕空间边缘检测。 Pass { Name Outline Cull Off ZWrite Off ZTest Always Blend SrcAlpha OneMinusSrcAlpha HLSLPROGRAM #pragma vertex vert #pragma fragment frag #include Packages/com.unity.render-pipelines.universal/ShaderLibrary/Core.hlsl struct Attributes { float4 positionOS : POSITION; }; struct Varyings { float4 positionHCS : SV_POSITION; }; Varyings vert(Attributes IN) { Varyings OUT; VertexPositionInputs positionInputs GetVertexPositionInputs(IN.positionOS.xyz); OUT.positionHCS positionInputs.positionCS; return OUT; } // 声明纹理和采样器 TEXTURE2D(_CameraDepthTexture); SAMPLER(sampler_CameraDepthTexture); TEXTURE2D(_CameraNormalsTexture); SAMPLER(sampler_CameraNormalsTexture); float4 _OutlineColor; float _OutlineWidth; float4 frag(Varyings IN) : SV_Target { // 屏幕UV坐标 float2 uv IN.positionHCS.xy / _ScreenParams.xy; // 采样当前像素的深度和法线 float depthCenter SAMPLE_TEXTURE2D(_CameraDepthTexture, sampler_CameraDepthTexture, uv).r; float3 normalCenter SAMPLE_TEXTURE2D(_CameraNormalsTexture, sampler_CameraNormalsTexture, uv).rgb; // 边缘检测检查相邻像素的深度和法线差异 float2 texelSize 1.0 / _ScreenParams.xy; float depthThreshold 0.001 * _OutlineWidth; float normalThreshold 0.4; float edge 0; // 简单的Sobel算子或周围采样 for (int x -1; x 1; x) { for (int y -1; y 1; y) { if (x 0 y 0) continue; float2 offsetUV uv float2(x, y) * texelSize * _OutlineWidth; float depthSample SAMPLE_TEXTURE2D(_CameraDepthTexture, sampler_CameraDepthTexture, offsetUV).r; float3 normalSample SAMPLE_TEXTURE2D(_CameraNormalsTexture, sampler_CameraNormalsTexture, offsetUV).rgb; // 深度差或法线差过大则认为是边缘 if (abs(depthSample - depthCenter) depthThreshold || dot(normalSample, normalCenter) normalThreshold) { edge 1; break; } } if (edge 0.5) break; } return float4(_OutlineColor.rgb, edge * _OutlineColor.a); } ENDHLSL } } }这个着色器是一个屏幕后处理着色器。它不直接渲染物体而是在所有物体渲染完毕后对全屏幕图像进行分析通过比较相邻像素的深度和法线信息来找出物体的边缘然后将边缘部分染成指定的轮廓颜色。这种方法的好处是与物体复杂度无关性能稳定。4.2 第二步创建 URP Renderer Feature在 Project 窗口右键Create Rendering Universal Render Pipeline Renderer Feature选择Fullscreen Screen Pass模板Unity 新版本提供或创建一个空的 C# 脚本命名为OutlineRendererFeature。using UnityEngine; using UnityEngine.Rendering; using UnityEngine.Rendering.Universal; public class OutlineRendererFeature : ScriptableRendererFeature { [System.Serializable] public class OutlineSettings { public Color outlineColor Color.yellow; [Range(0.1f, 10f)] public float outlineWidth 2.0f; public Material outlineMaterial; // 我们将动态创建材质避免手动拖拽丢失 } public OutlineSettings settings new OutlineSettings(); private OutlineRenderPass _outlinePass; private Material _outlineMaterial; // 内部持有的材质引用 public override void Create() { if (_outlinePass null) { _outlinePass new OutlineRenderPass(); } // 动态创建材质球绑定我们写的着色器 if (_outlineMaterial null) { Shader outlineShader Shader.Find(Hidden/Outline); if (outlineShader ! null) { _outlineMaterial new Material(outlineShader); } else { Debug.LogError(Outline shader not found. Please create the shader first.); } } // 将设置传递给材质 if (_outlineMaterial ! null) { _outlineMaterial.SetColor(_OutlineColor, settings.outlineColor); _outlineMaterial.SetFloat(_OutlineWidth, settings.outlineWidth); } } public override void AddRenderPasses(ScriptableRenderer renderer, ref RenderingData renderingData) { if (renderingData.cameraData.cameraType CameraType.Game) { if (_outlineMaterial ! null) { _outlinePass.Setup(_outlineMaterial); renderer.EnqueuePass(_outlinePass); } } } protected override void Dispose(bool disposing) { // 清理动态创建的材质防止内存泄漏 if (_outlineMaterial ! null) { CoreUtils.Destroy(_outlineMaterial); _outlineMaterial null; } base.Dispose(disposing); } private class OutlineRenderPass : ScriptableRenderPass { private Material _material; private RTHandle _cameraColorTarget; public void Setup(Material material) { _material material; renderPassEvent RenderPassEvent.AfterRenderingTransparents; // 在透明物体渲染后执行 } public override void OnCameraSetup(CommandBuffer cmd, ref RenderingData renderingData) { // 获取相机的颜色纹理 _cameraColorTarget renderingData.cameraData.renderer.cameraColorTargetHandle; } public override void Execute(ScriptableRenderContext context, ref RenderingData renderingData) { if (_material null) return; CommandBuffer cmd CommandBufferPool.Get(Outline Pass); // 使用Blit命令将当前屏幕图像与我们的轮廓材质混合 Blit(cmd, _cameraColorTarget, _cameraColorTarget, _material, 0); context.ExecuteCommandBuffer(cmd); CommandBufferPool.Release(cmd); } } }关键点解析动态创建材质我们在Create()方法中使用Shader.Find和new Material()动态创建材质。这彻底杜绝了因在 Inspector 面板中手动拖拽材质球而后材质球被误删导致的“Missing”引用错误。材质球随 Feature 生命周期管理。参数传递将OutlineSettings中配置的颜色和宽度通过Material.SetXXX方法传递给动态创建的材质。所有配置集中在一处。资源清理重写Dispose方法确保动态创建的材质在 Feature 被销毁时也被销毁避免内存泄漏。4.3 第三步配置 URP Renderer Asset在 Project 中找到你的 URP 配置文件通常名为UniversalRP-HighQuality或ForwardRenderer。在 Inspector 中找到Renderer Features列表点击Add Renderer Feature选择我们刚创建的OutlineRendererFeature。现在你可以直接在 Inspector 中调整轮廓颜色和宽度。outlineMaterial字段虽然显示但它是通过代码动态赋值的无需手动操作因此不会出现“Missing”。4.4 第四步创建选中管理器稳固资源版现在我们需要一个脚本来管理“哪些物体被选中”。这个脚本是纯逻辑的不直接持有易丢失的资源。using System.Collections.Generic; using UnityEngine; public class RuntimeSelectionManager : MonoBehaviour { public static RuntimeSelectionManager Instance { get; private set; } // 存储被选中的物体。使用GameObject引用是安全的。 private HashSetGameObject _selectedObjects new HashSetGameObject(); // 轮廓颜色和宽度这里可以覆盖或与Renderer Feature的设置同步 public Color outlineColor Color.cyan; public float outlineWidth 3.0f; // 一个材质属性块用于高效修改物体材质属性避免创建新的材质实例 private MaterialPropertyBlock _propertyBlock; // 轮廓显示所需的着色器属性ID提前计算好以提高性能 private static readonly int OutlineColorID Shader.PropertyToID(_OutlineColor); private static readonly int OutlineWidthID Shader.PropertyToID(_OutlineWidth); private static readonly int IsOutlineEnabledID Shader.PropertyToID(_IsOutlineEnabled); void Awake() { if (Instance ! null Instance ! this) { Destroy(this); return; } Instance this; _propertyBlock new MaterialPropertyBlock(); } void Update() { // 示例点击鼠标左键选中物体 if (Input.GetMouseButtonDown(0)) { Ray ray Camera.main.ScreenPointToRay(Input.mousePosition); if (Physics.Raycast(ray, out RaycastHit hit)) { ToggleSelection(hit.collider.gameObject); } } } public void ToggleSelection(GameObject obj) { if (_selectedObjects.Contains(obj)) { DeselectObject(obj); } else { SelectObject(obj); } } private void SelectObject(GameObject obj) { if (obj null) return; _selectedObjects.Add(obj); ApplyOutlineToObject(obj, true); Debug.Log($Selected: {obj.name}); } private void DeselectObject(GameObject obj) { if (obj null) return; _selectedObjects.Remove(obj); ApplyOutlineToObject(obj, false); Debug.Log($Deselected: {obj.name}); } private void ApplyOutlineToObject(GameObject obj, bool enable) { // 获取物体上所有的Renderer组件MeshRenderer, SkinnedMeshRenderer等 var renderers obj.GetComponentsInChildrenRenderer(); foreach (var renderer in renderers) { // 获取当前的材质属性块 renderer.GetPropertyBlock(_propertyBlock); if (enable) { // 设置轮廓属性 _propertyBlock.SetColor(OutlineColorID, outlineColor); _propertyBlock.SetFloat(OutlineWidthID, outlineWidth); _propertyBlock.SetFloat(IsOutlineEnabledID, 1.0f); } else { // 禁用轮廓 _propertyBlock.SetFloat(IsOutlineEnabledID, 0.0f); } // 将修改后的属性块应用回Renderer renderer.SetPropertyBlock(_propertyBlock); } } // 提供给其他脚本的接口 public void ClearAllSelection() { foreach (var obj in new HashSetGameObject(_selectedObjects)) { DeselectObject(obj); } _selectedObjects.Clear(); } }关键点解析使用MaterialPropertyBlock这是避免“Missing”材料和提升性能的关键。我们不直接替换物体的材质这会产生新的材质实例造成性能开销和资源管理混乱而是通过MaterialPropertyBlock修改其材质属性。即使物体原来的材质丢失PropertyBlock也只是修改失败不会导致脚本引用断裂或报“Missing”错误。静态实例使用单例模式方便全局访问。安全的资源引用脚本只引用GameObject和Renderer这些都是场景中稳固的对象引用只要物体不销毁引用就有效。4.5 第五步修改着色器以响应属性块为了让屏幕空间轮廓着色器知道“该画哪个物体”我们需要一个更精确的方法。屏幕空间深度/法线边缘检测会画出所有物体的边缘。更优的方案是结合Stencil Buffer模板缓冲区或自定义渲染层。这里介绍使用自定义渲染层Rendering Layer Mask的方法这是 URP/HDRP 推荐的方式修改轮廓着色器使其只对特定渲染层的物体进行边缘检测。这需要修改 URP Renderer Feature让它只渲染特定层的物体到一张临时纹理然后轮廓 Pass 只处理这张纹理。修改选中管理器在ApplyOutlineToObject中将被选中物体的渲染层renderer.renderingLayerMask设置为一个自定义的层例如1 31使用最高的位。修改 Renderer Feature创建两个 Pass。第一个 Pass 使用一个特殊的着色器将指定渲染层的物体渲染到一张纯色纹理中。第二个 Pass我们的轮廓后处理 Pass则读取这张纹理只对其中有颜色的区域即被选中物体进行边缘检测并绘制轮廓。由于实现代码较长其核心在于在 URP Renderer Asset 中创建一个新的Layer如命名为Outline。在OutlineRendererFeature中配置一个RenderObjects类型的 Pass设置其Filters Layer Mask为Outline层将其渲染到一个RTHandle渲染纹理句柄中。修改后处理轮廓着色器采样这张特定的渲染纹理而不是整个场景的深度/法线来判断边缘。通过这种方式我们将“选中状态”与“渲染层”这个稳固的引擎系统绑定完全避免了材质球、脚本组件等资源的直接引用从根本上消除了“Missing”的可能性。5. 常见问题排查与性能优化5.1 问题排查清单现象可能原因解决方案运行时无任何轮廓1. URP Renderer Feature 未添加或未启用。2. 轮廓着色器编译错误。3. 相机未使用配置好的 URP Renderer。1. 检查 URP Renderer Asset 的 Renderer Features 列表。2. 在 Project 中选中OutlineShader查看 Inspector 底部是否有编译错误。3. 检查相机Renderer选项是否指向正确的 Renderer Asset。轮廓颜色/宽度不生效MaterialPropertyBlock属性名与着色器中Properties块名称或SetXXX使用的 ID 不匹配。确保脚本中的OutlineColorID对应_OutlineColor且着色器中有同名属性。使用Shader.PropertyToID获取 ID 是最佳实践。轮廓在部分物体上闪烁或错位屏幕空间边缘检测对深度变化剧烈的区域如物体与背景交界敏感可能受抗锯齿TAA或运动模糊影响。1. 尝试调整depthThreshold和normalThreshold参数。2. 考虑使用基于几何体膨胀Geometry Shader 或第二遍渲染放大模型的方法稳定性更高但性能开销稍大。构建Build后功能失效动态创建的着色器或材质未正确包含在构建中。确保着色器被引用。最保险的方法是将轮廓着色器放入“Always Included Shaders”列表Project Settings Graphics Always Included Shaders。脚本显示为“Missing”脚本本身编译错误或其所依赖的程序集如UnityEditor在运行时不存在。1. 检查 Console 窗口的编译错误。2.绝对确保运行时脚本中没有任何using UnityEditor;语句或调用EditorApplication、AssetDatabase等编辑器 API。5.2 性能优化建议控制选中物体数量屏幕空间方法性能开销与屏幕分辨率相关与物体数量无关。但基于渲染层的方法需要为选中物体额外渲染一次应避免单帧内选中过多物体如超过20个复杂网格。使用对象池管理轮廓渲染器如果需要为大量动态生成的对象添加轮廓能力可以考虑预实例化一个带轮廓材质的渲染器对象池。简化轮廓着色器移除不必要的复杂计算。我们的示例着色器已经相当高效。分帧更新如果选中集更新非常频繁可以考虑将ApplyOutlineToObject的操作分散到多帧完成避免单帧卡顿。6. 总结与扩展思路通过以上步骤我们构建了一个不依赖易丢失资源、兼容现代渲染管线URP/HDRP的运行时选中高亮系统。其核心优势在于资源稳固通过代码动态创建材质、使用MaterialPropertyBlock、绑定渲染层最大程度避免了“Missing”引用。管线兼容基于ScriptableRendererFeature或CustomPass与 Unity 官方渲染流程无缝集成。可维护性强所有逻辑清晰分层便于调试和扩展。这个系统可以轻松扩展以实现更多功能多状态高亮除了选中还可以定义“悬停”、“可交互”、“危险”等状态对应不同的轮廓颜色。闪烁动画在RuntimeSelectionManager的Update中根据时间动态修改outlineColor的 Alpha 值或宽度实现呼吸闪烁效果。与UI联动当物体被选中时同步在 UI 上显示其信息面板。我个人在多个商业项目中采用了类似的架构它最大的价值在于将视觉效果与游戏逻辑解耦。美术同学可以通过调整 Renderer Feature 的参数直接控制轮廓外观而程序同学只需调用RuntimeSelectionManager.Instance.SelectObject(obj)即可。这种分工明确、依赖清晰的设计是保证项目长期稳定运行、避免出现各种诡异“Missing”错误的关键。