先说结论:90% 的"碰撞不生效",不是代码写错了,是 Rigidbody 没配对。
表格
| 组件 | 干什么 | 少了会怎样 |
|---|---|---|
| Collider | 定义形状(Box / Sphere / Capsule / Mesh) | 完全没有碰撞,穿过去 |
| Rigidbody | 让物体参与物理模拟、产生回调 | 静态物体,两个静态之间没有任何回调 |
| isTrigger(Collider 上的勾) | 只报告,不产生物理阻挡 | 勾了就被弹开,没勾就穿不过去 |
两条硬规则,背下来:
isTrigger 决定走哪套函数:勾了 → OnTriggerXXX;没勾 → OnCollisionXXX。两套不会同时触发。不想要物理反弹,只想知道"进来了没有",就用这个。
配置:
SphereCollider + 勾 Is Trigger,不需要 RigidbodyCapsuleCollider + Rigidbody(哪怕 Is Kinematic 勾上也行)using UnityEngine;
// 挂在金币上
public class Coin : MonoBehaviour
{
void OnTriggerEnter(Collider other)
{
// CompareTag 比 other.tag == "Player" 好,后者有 GC 分配
if (!other.CompareTag("Player")) return;
Debug.Log("吃到了");
Destroy(gameObject);
}
}三个函数的区别:
void OnTriggerEnter(Collider other) { } // 刚进来那一帧,一次
void OnTriggerStay (Collider other) { } // 待在里面,每个物理帧都调
void OnTriggerExit (Collider other) { } // 离开那一帧,一次注意 OnTriggerEnter 只给你 Collider,没有接触点、没有法线。 要位置就 other.transform.position 或者 other.ClosestPoint(transform.position)。
子弹打墙、箱子落地、球撞球,用这套。
配置: 双方都有 Collider(不勾 Is Trigger),动的一方有 Rigidbody(不勾 Is Kinematic)。
void OnCollisionEnter(Collision collision)
{
// 撞击强度,用来判断"撞得狠不狠"
if (collision.relativeVelocity.magnitude < 2f) return;
// 接触点(可能多个)
ContactPoint c = collision.GetContact(0);
Debug.Log($"撞到 {collision.gameObject.name},点 {c.point},法线 {c.normal}");
// 播放音效 / 生成火花
// Instantiate(sparkPrefab, c.point, Quaternion.LookRotation(c.normal));
}Collision 里能拿到的:

表格
| 字段 | 含义 |
|---|---|
| collider / gameObject | 对方 |
| relativeVelocity | 相对速度,判撞击力度 |
| impulse | 冲量,比速度更准(考虑了质量) |
| contactCount / GetContact(i) | 接触点数量和内容 |
| rigidbody | 对方的 Rigidbody,可能为 null |
GetContact(0) 前先判 contactCount > 0,虽然极少为 0,但线上崩过一次就够你记住。
这是最值钱的部分。
表格
| 现象 | 原因 | 解法 |
|---|---|---|
| 完全没反应 | 双方都没 Rigidbody | 给一方加 Rigidbody,勾 Kinematic 也行 |
| 完全没反应 | 两个都是 Kinematic | Kinematic × Kinematic 不产生回调,改一个为非 Kinematic,或改用主动查询 |
| 穿过去了但没回调 | 勾了 Is Trigger,却写的 OnCollisionEnter | 换成 OnTriggerEnter |
| 被弹开了 | 该勾 Is Trigger 没勾 | 勾上 |
| 编辑器正常,某两层就是不撞 | Layer Collision Matrix | Project Settings → Physics → 取消勾选的格子勾回来 |
| 高速物体直接穿墙 | 离散步进漏检(tunneling) | Rigidbody → Collision Detection 改 Continuous Dynamic;或改用 Raycast 判 |
| 脚本挂在子物体上收不到 | 回调发给带 Rigidbody 的那个物体 | 脚本挂父物体,或用 GetComponentInParent |
| MeshCollider 死活不撞 | 非 Convex 的 MeshCollider 不能和另一个非 Convex 撞 | 勾 Convex,或换 Box/Capsule |
| 非 Convex Mesh + 非 Kinematic Rigidbody | Unity 不支持这个组合 | 勾 Kinematic,或勾 Convex |
| 物体不动了就不再触发 | Rigidbody 进入 Sleep | rb.WakeUp(),或别让它睡 |
| 移动后立刻查询查不到 | Transform 改了但物理世界没同步 | Physics.SyncTransforms() |
补一句:用 transform.position 硬移 Rigidbody 是"瞬移",会跳过中间路径。 想保留物理检测,用 rb.MovePosition(),并且写在 FixedUpdate 里。
回调的问题:状态分散、时序难控、对象销毁时 OnTriggerExit 不一定来。 做技能范围、地面判定、AI 感知,主动查询更干净。
// 球形范围,返回所有重叠的 Collider
Collider[] hits = Physics.OverlapSphere(
transform.position,
5f,
LayerMask.GetMask("Enemy"), // 只查这一层,别查全部
QueryTriggerInteraction.Ignore // 忽略触发器
);
foreach (var h in hits)
h.GetComponent<IDamageable>()?.TakeDamage(10);只想知道"有没有",不要数组:
if (Physics.CheckSphere(transform.position, 0.3f, groundMask))
isGrounded = true;别用 LayerMask.GetMask() 每帧调,字符串转 mask 有开销。声明成字段在 Inspector 里选:
[SerializeField] LayerMask enemyMask; // Inspector 里勾层,零开销if (Physics.Raycast(transform.position, transform.forward, out RaycastHit hit, 10f, obstacleMask))
{
Debug.Log($"前方 {hit.distance} 米有 {hit.collider.name}");
Debug.DrawLine(transform.position, hit.point, Color.red);
}射线默认会打到 Trigger(Physics.queriesHitTriggers 默认 true)。不想打到就传 QueryTriggerInteraction.Ignore。
// 胶囊体扫掠,模拟角色前进会不会撞
Physics.SphereCast(origin, 0.5f, dir, out hit, 2f, mask);
Physics.BoxCast(center, halfExtents, dir, out hit, rot, 2f, mask);OverlapSphere 每次分配数组。高频调用用 NonAlloc:
readonly Collider[] buffer = new Collider[32];
int count = Physics.OverlapSphereNonAlloc(pos, radius, buffer, mask);
for (int i = 0; i < count; i++) { /* buffer[i] */ }注意:buffer 满了会静默截断,count == buffer.Length 时说明可能漏了。新版本 Unity 提供了 List<Collider> 重载,能自动扩容,优先用那个。
3D 的函数在 2D 里一个都不会调。 别混。
表格
| 3D | 2D |
|---|---|
| Rigidbody | Rigidbody2D |
| BoxCollider | BoxCollider2D |
| OnCollisionEnter(Collision) | OnCollisionEnter2D(Collision2D) |
| OnTriggerEnter(Collider) | OnTriggerEnter2D(Collider2D) |
| Physics.Raycast | Physics2D.Raycast |
| Physics.OverlapSphere | Physics2D.OverlapCircle |
| Project Settings → Physics | Project Settings → Physics 2D |
2D 的 Layer Collision Matrix 是独立的一份,3D 那边勾了没用。
1. 物理逻辑写 Update 里 碰撞回调在物理帧(默认 0.02s)发出,Update 是渲染帧。施力、移动 Rigidbody 一律放 FixedUpdate,否则手感随帧率飘。
2. OnTriggerExit 不可靠 对象被 Destroy 或 SetActive(false) 时,Exit 不一定发。所以别把"清空状态"只写在 Exit 里。范围类逻辑用主动查询 + 每帧重算,天然没这个问题。
3. 用 other.tag == "X" .tag 属性有 GC 分配。用 CompareTag("X")。更好的做法是 other.TryGetComponent<Player>(out var p)——直接拿组件,省掉标签这层约定。
4. 缩放带负数或非均匀 MeshCollider 在负缩放下法线翻转,行为诡异。角色一律用 Capsule,别用 Mesh。
5. CharacterController 不走 OnCollisionEnter 它自带胶囊体,碰撞回调是 OnControllerColliderHit。别在它身上等 OnCollisionEnter,等不到。
6. 调试看不见形状
Debug.DrawLine 把射线画出来,比打印日志直观十倍平台跳跃里最容易写错的就是这个。用 OnCollisionStay 判地面会抖,改成主动查询:
using UnityEngine;
public class GroundCheck : MonoBehaviour
{
[SerializeField] Transform checkPoint; // 脚底空物体
[SerializeField] float radius = 0.25f;
[SerializeField] LayerMask groundMask; // Inspector 里只勾 Ground
public bool IsGrounded { get; private set; }
void FixedUpdate()
{
IsGrounded = Physics.CheckSphere(
checkPoint.position, radius, groundMask,
QueryTriggerInteraction.Ignore);
}
void OnDrawGizmosSelected()
{
if (checkPoint == null) return;
Gizmos.color = IsGrounded ? Color.green : Color.red;
Gizmos.DrawWireSphere(checkPoint.position, radius);
}
}OnDrawGizmosSelected 这段别省。选中角色就能在 Scene 里看到那个球,半径调大调小一目了然,比反复试跳快得多。
OnCollisionEnterOnTriggerEnterPhysics.OverlapSphere / CheckSphereRaycast / SphereCast免责声明:本文系网络转载或改编,未找到原创作者,版权归原作者所有。如涉及版权,请联系删