1. 项目概述从“打不中”到“穿墙而过”的射线检测实战在Unity游戏开发里射线检测Raycast是处理攻击判定、视线检测、物体拾取等交互的基石。但很多开发者尤其是刚接触物理系统的朋友经常会遇到一个经典难题明明子弹飞得飞快代码逻辑看着也没毛病可敌人就是不掉血。或者想实现一个酷炫的“子弹穿墙”或“敌人透视”效果却不知道如何让射线聪明地忽略墙壁只关注目标。这背后往往是对LayerMask和射线检测原理的理解不够深入。今天我们就以“实现敌人透视/子弹穿墙效果”为目标深入聊聊Unity射线检测的进阶用法。这不仅仅是写一行Physics.Raycast那么简单它涉及到2D/3D环境下的方向处理、高速运动物体的轨迹覆盖、以及如何精准地使用LayerMask来过滤我们想打中和想忽略的东西。我会结合一个实际的“高速穿透子弹”案例拆解其中所有坑点并给出2024年仍适用的、经过优化的解决方案。无论你是想做一个FPS游戏的穿甲弹还是一个策略游戏的“战争迷雾”透视效果这里的思路都能直接套用。2. 核心原理拆解为什么你的射线总是“失明”在动手写代码之前我们必须搞清楚射线检测到底是怎么工作的。很多人把它想象成一条“无限细的激光”只在发射的那一瞬间检查一次。这种理解在低速情况下或许可行但在游戏里尤其是帧率波动和高速物体面前就会漏洞百出。2.1 射线检测的本质离散采样与连续世界的矛盾Unity的物理引擎无论是PhysX还是Box2D本质上是基于离散时间步长进行更新的。在FixedUpdate中引擎计算物体的新位置然后检查碰撞。Raycast也是一次离散的采样它检查的是从起点出发沿着某个方向在指定长度的一条线段上是否存在碰撞体。这就引出了第一个核心问题高速子弹的“隧道效应”。假设子弹每帧移动10个单位而敌人的碰撞体只有2个单位宽。如果子弹在帧A位于敌人前方11个单位在帧B位于敌人后方1个单位那么在这两帧之间子弹的实际运动轨迹穿过了敌人但无论是帧A还是帧B的瞬间从子弹位置发射的射线都没有与敌人发生交集。敌人就这样被“穿过”了没有触发任何检测。解决方案思路我们不能只检测当前帧的位置。必须检测从上一帧结束的位置到当前帧位置的整个运动轨迹。这相当于把一次点的检测扩展为一条线段或者说一个很薄的“体”的检测。Physics2D.RaycastAll或Physics.SphereCast等API就是用来解决这个问题的。2.2 LayerMask不只是0和1的开关LayerMask是控制射线“能看见什么”的关键。它本质上是一个32位的位掩码bitmaskUnity场景中的每个Layer对应其中的一个位0-31。常见的错误用法是// 错误示例试图直接设置层索引 int layer 8; // 假设“Enemy”层是第8层 Physics.Raycast(ray, out hit, distance, layer); // 这样很可能检测不到正确的理解是LayerMask期望的是一个掩码值它标记了哪些层是需要被检测的。你需要使用LayerMask.GetMask方法或者通过位运算来构造这个掩码。// 正确示例1获取单个层的掩码 LayerMask enemyMask LayerMask.GetMask(Enemy); Physics.Raycast(ray, out hit, distance, enemyMask); // 正确示例2获取多个层的掩码 LayerMask targetMask LayerMask.GetMask(Enemy, Destructible); Physics.Raycast(ray, out hit, distance, targetMask); // 正确示例3排除某个层比如UI LayerMask everythingExceptUI ~LayerMask.GetMask(UI); Physics.Raycast(ray, out hit, distance, everythingExceptUI);实现“穿墙”或“透视”的核心技巧就在于LayerMask的灵活运用子弹穿墙你的子弹射线应该只检测“敌人”和“可破坏物”而不检测“墙壁”层。这样射线遇到墙壁时会被忽略继续向前检测直到命中目标或达到最大距离。敌人透视你需要从玩家角色发射多条射线或一个扇形区域检测但只针对“敌人”层。同时你可能需要先发射一条检测“墙壁”层的射线如果被墙壁阻挡则即使后面有敌人透视效果也不显示或显示为半透明轮廓以此模拟真实的视线遮挡。2.3 2D与3D射线检测的关键差异这是一个极易踩坑的地方特别是在2D项目中。坐标系3D射线使用Vector3方向常用transform.forwardZ轴正方向。而在2D使用Physics2D中世界是XY平面transform.forward指向的是屏幕内外的Z轴与运动平面垂直。在2D中物体的前进方向通常用transform.rightX轴正方向如果精灵默认朝右或通过速度向量rb.velocity.normalized来获取。API命名空间3D射线用Physics.Raycast()2D射线用Physics2D.Raycast()。两者参数类似但属于不同体系不能混用。碰撞体组件3D对应Collider2D对应Collider2D。3. 实战构建一个可靠的高速穿透子弹系统现在我们把理论付诸实践。我们将修复一个典型的“高速穿透子弹无效”问题并扩展其功能实现可配置的穿透效果。3.1 问题代码诊断我们先看一段有问题的旧代码常见于新手教程或早期项目public class Bullet : MonoBehaviour { public float speed 20f; public int damage 10; public LayerMask enemyLayer; private string HitName null; private Liststring HitNames new Liststring(); void Update() { transform.Translate(Vector3.forward * speed * Time.deltaTime); RaycastHit hit; if (Physics.Raycast(transform.position, transform.forward, out hit, 0.5f, enemyLayer)) { if (HitName null !HitNames.Contains(hit.collider.gameObject.name)) { HitNames.Add(hit.collider.gameObject.name); hit.collider.GetComponentEnemy().TakeDamage(damage); } } } }这段代码至少有五个致命问题方向错误2D项目在2D环境中使用了transform.forward。隧道效应射线长度只有0.5f对于高速子弹这个检测范围远小于每帧位移必然漏检。低效的重复检测判断用Liststring存储已命中敌人名字并用Contains方法查找效率低。且HitName永远不为null判断多余。脆弱的组件获取直接GetComponentEnemy()如果敌人预制体上没有这个脚本会抛出异常导致游戏对象无法销毁可能引发内存泄漏。LayerMask配置风险未在编辑器或代码中验证enemyLayer是否包含了敌人实际所在的层。3.2 修复与进阶实现方案以下是重构后的、健壮的Bullet脚本包含了穿透逻辑和轨迹检测。using System.Collections.Generic; using UnityEngine; public class AdvancedPiercingBullet : MonoBehaviour { [Header(基础属性)] [SerializeField] private float bulletSpeed 30f; [SerializeField] private int baseDamage 15; [SerializeField] private float maxTravelDistance 50f; [SerializeField] private int maxPierceCount 3; // 最大穿透敌人数量 [Header(检测设置)] [SerializeField] private LayerMask targetLayers; // 在Inspector中勾选“Enemy”、“Destructible”等层 [SerializeField] private float detectionRadius 0.1f; // 用于SphereCast的半径应对细小目标 [Header(调试)] [SerializeField] private bool drawDebugRay true; // 私有变量 private Rigidbody2D rb; // 2D版本3D请改用Rigidbody private Vector2 launchPosition; private Vector2 previousPosition; private int currentPierceCount 0; private HashSetint hitEnemyInstanceIDs new HashSetint(); // 使用InstanceID确保唯一性 private void Awake() { rb GetComponentRigidbody2D(); if (rb null) { Debug.LogError(${gameObject.name}: Bullet 需要 Rigidbody2D 组件。); enabled false; return; } } private void Start() { launchPosition transform.position; previousPosition transform.position; // 初始化速度。假设子弹朝右2D或前方3D发射 // 2D: rb.velocity transform.right * bulletSpeed; // 3D: rb.velocity transform.forward * bulletSpeed; } private void FixedUpdate() { HandleMovementDetection(); CheckDistanceLimit(); } /// summary /// 核心方法处理运动轨迹上的碰撞检测 /// /summary private void HandleMovementDetection() { Vector2 currentPosition transform.position; // 计算本帧移动的方向和距离 Vector2 moveDirection (currentPosition - previousPosition).normalized; float moveDistance Vector2.Distance(previousPosition, currentPosition); // 关键检测从上一帧位置到当前位置的整个线段 RaycastHit2D[] hits; // 选择1使用RaycastAll进行线性检测适合子弹体积小 hits Physics2D.RaycastAll(previousPosition, moveDirection, moveDistance, targetLayers); // 选择2使用CircleCast/SphereCast进行体积检测适合子弹有一定体积检测更稳定 // hits Physics2D.CircleCastAll(previousPosition, detectionRadius, moveDirection, moveDistance, targetLayers); // 调试绘制 if (drawDebugRay) { Debug.DrawLine(previousPosition, currentPosition, Color.red, 0.5f); } ProcessHits(hits); // 更新上一帧位置为下一帧检测做准备 previousPosition currentPosition; } private void ProcessHits(RaycastHit2D[] hits) { // 按距离排序确保先处理路径上先碰到的物体 System.Array.Sort(hits, (a, b) a.distance.CompareTo(b.distance)); foreach (RaycastHit2D hit in hits) { // 检查穿透次数是否已达上限 if (currentPierceCount maxPierceCount) { DestroyBullet(); return; } // 获取被击中物体的唯一标识InstanceID int hitID hit.collider.gameObject.GetInstanceID(); // 检查是否已击中过同一个物体防止单帧内重复判定 if (hitEnemyInstanceIDs.Contains(hitID)) { continue; } // 尝试获取敌人的伤害处理接口或组件 IDamageable damageable hit.collider.GetComponentIDamageable(); if (damageable ! null) { // 应用伤害 damageable.TakeDamage(baseDamage); // 记录已击中 hitEnemyInstanceIDs.Add(hitID); currentPierceCount; // 这里可以添加击中特效、音效等 OnHitTarget(hit.point, hit.normal); } else { // 如果击中的不是可伤害对象但属于目标层比如一个可穿透的障碍物可以只记录ID但不增加穿透计数 // 或者直接视为阻挡物销毁子弹 // DestroyBullet(); // return; Debug.LogWarning($击中了层 {LayerMask.LayerToName(hit.collider.gameObject.layer)} 上的物体但该物体未实现 IDamageable 接口。); } } } private void CheckDistanceLimit() { if (Vector2.Distance(launchPosition, transform.position) maxTravelDistance) { DestroyBullet(); } } private void OnHitTarget(Vector2 hitPoint, Vector2 hitNormal) { // 实例化击中特效 // GameObject hitEffect Instantiate(hitEffectPrefab, hitPoint, Quaternion.LookRotation(hitNormal)); // Destroy(hitEffect, 1f); } private void DestroyBullet() { // 销毁前可以播放消失动画或特效 Destroy(gameObject); } // 可选的用于外部设置目标如追踪弹 public void SetTarget(Vector2 targetPoint) { Vector2 direction (targetPoint - (Vector2)transform.position).normalized; rb.velocity direction * bulletSpeed; } } // 定义一个伤害接口让所有可受伤物体实现提高代码的通用性和解耦性 public interface IDamageable { void TakeDamage(int damage); }3.3 关键配置与 Inspector 设置代码写好了在Unity编辑器里的配置同样重要否则代码再好也没用。层级Layer设置在Tags Layers设置中创建好所需的层例如Enemy、Wall、Destructible、Player。将你的敌人预制体Prefab的Layer设置为Enemy。将墙壁等障碍物的Layer设置为Wall。子弹预制体设置为子弹 GameObject 添加Rigidbody2D组件。将Body Type设置为Kinematic或Dynamic。如果设置为Dynamic记得将Gravity Scale设为0避免重力影响。添加Collider2D如BoxCollider2D。重要如果你希望子弹的物理碰撞和射线检测逻辑完全由脚本控制可以取消勾选Collider2D组件或者将其设置为Is Trigger并确保在射线检测API中包含了QueryTriggerInteraction参数2D中是Physics2D.queriesHitTriggers全局设置或RaycastHit2D的collider.isTrigger属性判断。将上面的AdvancedPiercingBullet脚本挂载上去。在脚本的Target Layers属性中点击下拉菜单勾选Enemy和Destructible但不要勾选Wall和Player。这就是实现“穿墙”的关键——让子弹的检测射线“看不见”墙。敌人预制体设置确保敌人有Collider2D用于被检测。创建一个脚本实现IDamageable接口并挂载。public class EnemyHealth : MonoBehaviour, IDamageable { public int health 100; public void TakeDamage(int damage) { health - damage; if (health 0) { Die(); } // 播放受击动画、音效等 } private void Die() { /* 死亡处理 */ } }4. 实现“敌人透视”效果“子弹穿墙”是让射线忽略某些层“敌人透视”则是让射线只关注某些层并结合图形渲染来表现。这里提供两种常见思路4.1 视线遮挡透视X-Ray Vision这种效果常用于战术游戏显示墙壁后的敌人轮廓。原理从玩家摄像机向每个已知的敌人或通过一个范围检测到的敌人发射一条射线。这条射线使用两个LayerMask进行两次检测或一次特殊检测。第一次检测检测Wall层。如果击中记录击中点与玩家的距离。第二次检测检测Enemy层但射线长度设为第一次检测到的击中距离如果有墙。如果这次也击中了敌人且敌人距离小于墙的距离即敌人在墙后则触发透视效果。实现步骤维护一个敌人列表可通过标签查找或触发器进入。在Update或LateUpdate中遍历每个敌人计算其屏幕位置或方向。执行上述的双重射线检测逻辑。根据检测结果控制敌人身上一个“轮廓材质”的显示与隐藏。这个材质通常使用Stencil Buffer或深度比较的Shader绘制在墙壁之上。public class EnemyOutlineManager : MonoBehaviour { public LayerMask wallLayer; public LayerMask enemyLayer; public float checkInterval 0.1f; // 降低检测频率优化性能 private ListEnemyOutline enemiesInRange new ListEnemyOutline(); private float timer 0; void Update() { timer Time.deltaTime; if (timer checkInterval) { timer 0; CheckEnemyVisibility(); } } void CheckEnemyVisibility() { foreach (var enemy in enemiesInRange) { Vector3 dirToEnemy (enemy.transform.position - transform.position).normalized; float distToEnemy Vector3.Distance(transform.position, enemy.transform.position); // 先检测到墙的距离 RaycastHit wallHit; bool wallBlocked Physics.Raycast(transform.position, dirToEnemy, out wallHit, distToEnemy, wallLayer); // 再检测敌人可以检测所有层或仅敌人层 RaycastHit enemyHit; bool enemyVisible Physics.Raycast(transform.position, dirToEnemy, out enemyHit, distToEnemy); if (enemyVisible enemyHit.collider.gameObject enemy.gameObject) { // 如果看到敌人并且没有墙阻挡 或 墙在敌人后面 if (!wallBlocked || wallHit.distance enemyHit.distance) { enemy.ShowOutline(false); // 正常显示不需要透视轮廓 } else { enemy.ShowOutline(true); // 显示透视轮廓 } } else { enemy.HideOutline(); // 完全看不见 } } } // ... 用于添加/移除enemiesInRange的方法 }4.2 小地图或UI图标透视这是一种更轻量级的方案不修改3D渲染而是在UI上显示图标。原理同样通过射线检测判断敌人是否在玩家“直接视线”内。如果不在则在小地图的对应方位或屏幕边缘显示一个指示敌人方向的图标。实现将世界坐标的敌人位置通过Camera.WorldToScreenPoint或Camera.WorldToViewportPoint转换为屏幕坐标。如果转换后的坐标在屏幕外则计算一个屏幕边缘的位置并在此处显示一个箭头图标。5. 性能优化与高级技巧当场景中需要大量射线检测时如大量子弹、AI视线性能至关重要。5.1 优化策略降低检测频率非关键检测如敌人AI的玩家感知不必每帧进行可以每0.2-0.5秒检测一次。使用非分配性APIPhysics2D.RaycastAll和Physics.SphereCastAll会返回新的数组产生GC垃圾回收压力。对于高频检测应使用非分配版本并重用数组。private RaycastHit2D[] hitBuffer new RaycastHit2D[10]; // 预分配数组 void FixedUpdate() { int hitCount Physics2D.RaycastNonAlloc(previousPosition, moveDirection, hitBuffer, moveDistance, targetLayers); for (int i 0; i hitCount; i) { // 处理 hitBuffer[i] } }分层检测与距离裁剪先进行粗略的、代价低的检测如距离判断、触发器范围筛选出潜在目标再对少数目标进行精确的射线检测。使用Physics Queries对于固定模式的检测如扇形、圆形区域可以使用Physics2D.OverlapCircle等形状检测API有时比多条射线更高效。5.2 处理复杂碰撞体与Trigger复合碰撞体如果一个敌人由多个子碰撞体组成射线可能击中任何一个。这时使用hit.collider.transform.root或hit.collider.GetComponentInParentIDamageable()来找到根物体或父级组件。Trigger碰撞体默认情况下射线检测不会命中Is Trigger为true的碰撞体。如果需要检测Trigger有几种方法不推荐全局设置Physics2D.queriesHitTriggers true;。这会影响所有物理查询。推荐使用API的重载参数Physics2D.Raycast(origin, direction, distance, layerMask, minDepth, maxDepth)这个重载无法直接控制。更常用的方法是如果你需要检测Trigger通常意味着你需要使用Physics2D.OverlapCircle这类重叠检测方法它们默认会检测Trigger。或者为需要被射线检测的Trigger物体单独设置一个层并在LayerMask中包含它然后通过hit.collider.isTrigger在代码中判断。5.3 调试与可视化良好的调试工具能极大提升开发效率。Debug.DrawRay和Debug.DrawLine在Scene视图中绘制射线这是最基本的调试手段。记得只在开发版本或打开调试开关时使用。自定义Editor脚本可以为你的子弹脚本编写一个自定义的Editor在Scene视图实时绘制出检测范围、运动轨迹和已命中列表。性能分析器Profiler定期使用Profiler查看Physics.Raycast和Physics2D.Raycast的调用开销确保它们没有成为性能瓶颈。6. 常见问题与排查清单当你按照教程做了但效果不对时请按以下清单逐一排查问题现象可能原因排查步骤完全检测不到任何物体1. LayerMask设置错误。2. 射线方向/起点错误。3. 碰撞体被禁用或未激活。4. (2D项目) 使用了3D的Physics API或反之。1. 在代码中打印LayerMask.value并在Inspector中核对勾选的层。2. 使用Debug.DrawRay绘制射线看其路径是否经过目标。3. 检查目标GameObject及其父物体的激活状态检查Collider组件的启用状态。4. 确认项目是2D还是3D并使用对应的Physics API。高速物体穿模检测不稳定1. “隧道效应”。每帧检测范围太小。2. 物体速度过快单帧位移远大于其碰撞体大小。1. 改用RaycastAll并检测从上一帧到当前帧的轨迹如本文方案。2. 考虑使用Physics.SphereCast或Physics.CapsuleCast增加检测体积。3. 提高物理更新频率Time.fixedDeltaTime但这会增加CPU负担。能检测到但伤害应用了多次1. 单帧内同一物体被检测到多次。2. 伤害逻辑没有防重复机制。1. 使用HashSetint记录已命中物体的InstanceID并在应用伤害前检查。2. 确保伤害逻辑在单次碰撞事件中只执行一次例如在OnCollisionEnter中而不是OnCollisionStay。穿透效果不对打穿第一个敌人后子弹就消失1. 穿透计数逻辑有误。2. 射线在击中第一个敌人后停止。1. 检查maxPierceCount和currentPierceCount的逻辑。2. 确保使用的是RaycastAll或SphereCastAll而不是普通的Raycast后者在命中第一个物体后就返回。3. 检查是否在击中任何物体包括不可伤害物后都调用了DestroyBullet。透视效果时有时无1. 射线检测的时机或频率问题。2. 透视材质或UI图标的显示/隐藏逻辑有竞态条件。1. 将透视检测放在LateUpdate中确保所有物体位置更新完毕后再检测。2. 为透视状态添加一个平滑过渡如淡入淡出避免闪烁。3. 检查射线检测的起点和终点是否准确例如是从摄像机还是玩家眼睛发射。最后记住射线检测是游戏交互的灵魂之一理解其原理并灵活运用LayerMask就能创造出丰富而可靠的游戏机制。从简单的点击拾取到复杂的战术透视其核心思想都是一致的让代码“看见”你想让它看见的东西忽略你不想让它看见的东西。多动手测试善用调试工具你就能彻底掌握这门技巧。