Cocos Creator 3.8.x物理系统详解：刚体与碰撞体核心机制与优化实践

1. 项目概述：为什么物理系统是游戏开发的“骨架”

做游戏开发，尤其是3D游戏，你迟早会碰到一个绕不开的核心模块：物理系统。它不像绚丽的粒子特效那样一眼就能抓住玩家眼球，也不像精巧的UI交互那样直接与玩家对话。物理系统更像是一个沉默的“骨架工程师”，它决定了游戏世界里的一切物体如何存在、如何运动、如何相互作用。一个角色从高处跳下是轻盈落地还是摔得七零八落，一颗子弹击中墙壁是反弹还是嵌入，一辆赛车过弯时是平稳漂移还是直接翻车——所有这些“感觉”对不对，都取决于物理系统是否真实、稳定且高效。

在 Cocos Creator 3.8.x 这个版本中，物理系统得到了显著的增强和优化，特别是对于刚体（RigidBody）和碰撞体（Collider）这两大基石的理解与运用，直接关系到你项目的物理表现和性能开销。很多开发者，尤其是从2D项目过渡到3D，或者初次接触物理引擎的朋友，常常会陷入一些误区：比如，给一个静态的建筑物也加上刚体，导致不必要的性能浪费；或者，混淆了碰撞体和触发器（Trigger）的用途，让本该阻挡玩家的空气墙变成了穿模的通道。

我自己在多个商业项目中踩过不少坑，也见证了物理系统从“能用”到“好用”的进化。这篇文章，我就以 Cocos Creator 3.8.x 为蓝本，结合最新的引擎特性和实际项目经验，为你彻底拆解物理系统中的刚体与碰撞体。我的目标不是复读官方文档，而是带你理解背后的设计哲学、掌握最佳实践、并避开那些文档里没写的“深坑”。无论你是想实现一个逼真的物理沙盒，还是仅仅需要一些基础的碰撞检测，相信这篇详解都能让你对 Cocos Creator 的物理系统有一个全新的、透彻的认识。

2. 物理系统核心架构与设计思路

在深入刚体和碰撞体之前，我们必须先理解 Cocos Creator 3.8.x 物理系统的整体架构。它不是一个从零开始自研的轮子，而是基于成熟的第三方物理引擎（目前主要是Cannon.js和Builtin，未来可能支持更多）进行封装和集成。这种设计带来了巨大的优势：我们无需关心底层复杂的数学计算和物理模拟算法，可以专注于游戏逻辑；同时，又能享受到成熟物理引擎的稳定性和性能。

2.1 物理世界（PhysicsWorld）与物理管理器

所有的物理模拟都发生在一个叫做“物理世界”的容器里。在 Cocos Creator 中，这个物理世界由PhysicsSystem单例管理器来创建和维护。你可以把它想象成一个独立的、遵循物理定律运行的平行空间。我们游戏场景中的节点，只有被“注册”到这个物理世界里，才会参与物理模拟。

关键设计考量：

• 模拟与渲染分离：物理模拟（计算位置、速度、碰撞）和图形渲染（把结果画到屏幕上）是两套独立的循环。通常物理模拟的频率（步长）是固定的（如每秒60次），而渲染帧率可能根据设备性能波动。这种分离保证了物理世界的确定性（在相同输入下，物理行为可复现）和稳定性。
• 重力与全局参数：物理世界有全局属性，最典型的就是重力加速度。在 Cocos Creator 的项目设置 -> 物理中，你可以配置这些全局参数。这里有一个非常重要的点：重力的方向。在3D空间中，默认是沿Y轴负方向（向下），但你的游戏可能是横版2.5D或者太空题材，理解并正确设置重力方向是第一步。

注意：物理世界的更新是自动的，你通常不需要手动调用。但了解其生命周期（例如在fixedUpdate中进行与物理相关的逻辑操作会更安全）对于处理复杂的交互逻辑至关重要。

2.2 刚体（RigidBody）：物理世界的“演员”

刚体，顾名思义，就是假设在运动中和受力作用后，形状和大小不变，而且内部各点的相对位置也不变的物体。它是物理模拟的主体。一个节点添加了刚体组件，就意味着它将被物理世界接管其运动状态。

刚体的核心属性与类型：刚体组件暴露了一系列属性，理解它们的含义是精准控制物理行为的关键：

1. 类型（Type）：这是刚体最重要的属性，决定了它如何参与物理模拟。

   • Dynamic（动态）：完全受物理定律支配。会受到重力、碰撞力的影响，速度、角速度会因受力而改变。玩家角色、飞行的炮弹、掉落的箱子通常都是动态刚体。
   • Static（静态）：在物理世界中完全静止不动。它不会因为碰撞而移动，但可以与其他刚体发生碰撞并影响对方。通常用于永远不会移动的环境物体，如地面、墙壁、静态的建筑。性能优化关键：将不会移动的物体设为 Static，能极大减少物理引擎的计算量。
   • Kinematic（运动学）：一种特殊的类型。它的运动完全由代码（通过设置position或velocity）驱动，不受重力或其他力的影响。但它可以推动动态刚体。常用于电梯、移动的平台、或者由玩家直接控制但需要复杂碰撞响应的角色（在某些特定设计下）。

2. 质量（Mass）与密度（Density）：质量决定了物体的惯性（改变其运动状态的难易程度）。密度则与碰撞体体积共同决定质量。一个质量大的动态刚体更难被推动，碰撞时传递的动量也更大。

3. 线性速度与角速度（Linear/Angular Velocity）：可以直接读取或设置刚体在三维空间中的移动速度和旋转速度。这是直接控制刚体运动最直接的方式。

4. 阻尼（Damping）：分为线性阻尼和角阻尼，用于模拟空气阻力等效果，使物体的运动逐渐停止。值越大，停止得越快。

刚体运动控制方式对比：

实操心得：对于大多数需要物理反馈的角色移动，我的经验是：优先考虑对动态刚体施加力或冲量。虽然直接设置velocity更简单，但它粗暴地覆盖了物理引擎的计算，容易导致角色“粘”在斜坡上或者以违反物理规律的方式运动。对于平台跳跃游戏，在起跳时施加一个向上的冲量 (applyImpulse)，在空中通过施加反向力来模拟空气阻力控制跳跃弧度，落地时的碰撞由物理引擎自然处理，这样得到的手感往往更扎实、更“有重量感”。

2.3 碰撞体（Collider）：物理世界的“形状”

如果说刚体定义了“谁在动”和“怎么动”，那么碰撞体就定义了“它的边界是什么”。碰撞体是一个几何形状组件，它附着在节点上，为物理引擎提供进行碰撞检测所需的体积信息。一个常见的误解是：有了刚体就有碰撞。实际上，刚体必须配合一个或多个碰撞体，才能参与碰撞检测。

碰撞体的形状类型：Cocos Creator 3.8.x 提供了多种基础碰撞体形状，你需要根据模型的实际轮廓来选择，在效果和性能之间取得平衡。

1. 盒碰撞体（Box Collider）：由中心点、大小（长宽高）定义的长方体。这是性能最好的形状，计算速度最快。如果你的物体外形近似长方体（如箱子、门、桌子），应优先使用它。
2. 球碰撞体（Sphere Collider）：由中心和半径定义的球体。计算复杂度极低，仅次于盒碰撞体。适用于球、胶囊状物体或作为复杂物体的简化碰撞体。
3. 胶囊碰撞体（Capsule Collider）：由圆柱体和两端的半球体组成。它非常适合用于角色控制器，因为它在处理斜坡、台阶和与其他形状碰撞时，比圆柱体更稳定，不易卡住。
4. 圆柱碰撞体（Cylinder Collider）：标准的圆柱体。注意，在有些物理引擎中，圆柱体与其他形状（特别是其他圆柱体）的碰撞计算可能不如胶囊体稳定。
5. 网格碰撞体（Mesh Collider）：使用3D模型的顶点数据来构建一个与模型外形高度一致的复杂碰撞体。这是性能最差但精度最高的选择。绝对不要将其用于可移动的动态刚体！通常只用于静态的、形状极其复杂且无法用简单形状拼接的环境（如一个布满孔洞的岩石）。

碰撞体与触发器（Is Trigger）：碰撞体组件上有一个至关重要的布尔属性：isTrigger。

• 当isTrigger = false（默认）时，这是一个实心的碰撞体。物理引擎会计算碰撞接触点、法线，并据此产生碰撞响应（如反弹、阻挡）。两个非触发器的碰撞体接触，会互相“推开”。
• 当isTrigger = true时，它就变成了一个触发器。物理引擎只检测是否有其他碰撞体进入了它的区域，但不会产生任何物理响应（不会阻挡运动）。这纯粹用于逻辑检测，比如检测玩家进入一个区域（如宝箱范围、陷阱区域、任务触发点）。

一个节点多个碰撞体：一个刚体节点可以挂载多个碰撞体组件。这非常有用！例如，对于一个角色：

• 你可以用一个胶囊碰撞体作为主体，处理与地面、墙壁的碰撞。
• 再添加一个稍大的球碰撞体作为“攻击检测范围”，并设置为触发器 (isTrigger = true)，当敌人进入这个球体范围时，触发攻击判定逻辑。
• 还可以在拳头位置添加一个小的盒碰撞体（也是触发器），只在攻击动画的特定帧激活，用于精确检测拳头是否击中目标。

这种组合方式，既能保证物理运动的稳定性，又能实现灵活的游戏逻辑检测，是高级物理应用的常见模式。

3. 刚体与碰撞体的协同工作流程

理解了各自的概念后，我们来看看它们是如何携手工作的。这个流程是物理系统运作的核心。

3.1 从创建到响应的完整生命周期

1. 组件添加与配置：在编辑器中，为一个节点添加RigidBody组件，并设置其类型、质量等属性。然后，添加一个或多个Collider组件（如 Box Collider），设置其大小、位置（Offset）和是否为触发器。
2. 物理世界注册：游戏运行时，该节点及其刚体、碰撞体信息会被自动注册到物理世界（PhysicsWorld）中。
3. 连续模拟：在每一帧的物理更新中：
   • 物理引擎根据重力、力、速度等，计算所有动态刚体的新位置和旋转。
   • 同时，检测所有碰撞体之间的重叠（对于触发器）或穿透（对于非触发器）。
4. 碰撞事件触发：当检测到碰撞或触发时，物理引擎会通过组件上的回调函数通知我们的游戏逻辑。这是我们将物理与游戏玩法连接起来的关键环节。
5. 同步渲染：物理计算完成后，刚体的新变换（位置、旋转）会被同步回其所在的节点，从而更新其在场景中的视觉表现。

3.2 碰撞检测与事件监听

Cocos Creator 提供了完善的碰撞事件回调接口，你需要在有碰撞体或刚体的节点上挂载一个自定义脚本，并实现相应的方法。

核心事件：

• onCollisionEnter：当非触发器碰撞体开始与另一个非触发器碰撞体接触时调用。（一次碰撞只调用一次）
• onCollisionStay：当非触发器碰撞体与另一个非触发器碰撞体保持接触时，每帧调用。
• onCollisionExit：当非触发器碰撞体与另一个非触发器碰撞体结束接触时调用。
• onTriggerEnter：当一个触发器碰撞体与另一个任意类型的碰撞体开始接触时调用。
• onTriggerStay：当一个触发器碰撞体与另一个任意类型的碰撞体保持接触时，每帧调用。
• onTriggerExit：当一个触发器碰撞体与另一个任意类型的碰撞体结束接触时调用。

代码示例与事件数据：

import { _decorator, Component, ColliderComponent, ITriggerEvent, ICollisionEvent } from 'cc'; const { ccclass, property } = _decorator; @ccclass('PlayerController') export class PlayerController extends Component { start() { // 获取碰撞体组件，并注册回调 let collider = this.getComponent(ColliderComponent); if (collider) { collider.on('onTriggerEnter', this.onTriggerEnter, this); collider.on('onCollisionEnter', this.onCollisionEnter, this); } } onTriggerEnter(event: ITriggerEvent) { // event.otherCollider: 与我发生触发检测的另一个碰撞体 // event.otherActor: 另一个碰撞体所在的节点（在Cocos Creator 3.x中可能需要通过otherCollider.node获取） let otherNode = event.otherCollider.node; console.log(`触发器进入：接触到了 ${otherNode.name}`); if (otherNode.name === 'Coin') { otherNode.destroy(); // 销毁金币节点 // 增加分数逻辑... } } onCollisionEnter(event: ICollisionEvent) { // event.otherCollider: 与我发生碰撞的另一个碰撞体 // event.contacts: 碰撞接触点信息数组（可用于播放碰撞音效、产生火花特效等） console.log(`发生碰撞！`); // 例如，可以根据碰撞相对速度播放不同音效 } }

注意事项：

• 事件区分：务必清楚onCollisionXXX和onTriggerXXX的触发条件。如果你给一个触发器写了onCollisionEnter，它是永远不会被调用的。
• 性能考虑：onStay事件每帧都会触发，如果在这个回调里执行非常耗时的操作（如查找大量节点、复杂计算），会对性能造成压力。尽量保持onStay内的逻辑轻量。
• 节点销毁：在事件回调中销毁节点（如拾取物品）是安全的，但要注意操作顺序，避免访问已销毁节点的属性。

4. 高级应用与性能优化实战

掌握了基础，我们就可以探讨一些更深入的话题和“踩坑”经验了。

4.1 角色控制器的实现模式

用物理驱动角色移动是让游戏手感更真实的关键，但实现起来有挑战。以下是几种常见模式：

1. “力驱动”模式：

   • 思路：将角色设为动态刚体，通过applyForce或applyImpulse来移动。
   • 优点：物理反馈最真实，有惯性，与环境互动自然（如被爆炸推开）。
   • 缺点：控制手感像“开滑冰鞋”，难以实现即停即走、精准的平台跳跃。需要仔细调节质量、阻尼和力的大小。
   • 技巧：在update中检测输入，但在fixedUpdate中施加力，以保证物理模拟的稳定性。可以通过检测是否在地面（用射线检测或碰撞检测）来限制空中移动。

2. “速度覆盖”模式：

   • 思路：将角色设为动态刚体，但通过直接设置linearVelocity来控制水平移动。
   • 优点：控制响应直接，手感类似传统非物理角色。
   • 缺点：容易与物理环境产生冲突。例如，在斜坡上，你设置的横向速度可能会被物理引擎纠正，导致角色滑动或卡住。需要配合射线检测来提前处理地形。
   • 技巧：只在水平面（X-Z平面）上设置速度，Y轴速度交给重力。使用胶囊碰撞体能极大改善在复杂地形上的表现。

3. “运动学”模式：

   • 思路：将角色设为运动学刚体。移动完全通过代码计算（例如，根据输入直接计算下一帧的位置），然后赋值给刚体的position或velocity。
   • 优点：绝对控制，无物理惯性，可以实现最精准的平台跳跃和解谜。
   • 缺点：所有碰撞响应都需要自己实现（比如碰到墙要停止移动）。失去了物理引擎带来的自动碰撞响应便利。
   • 技巧：通常需要自己实现一套基于碰撞体或射线检测的简单碰撞检测系统，以判断前方是否有障碍。

我的经验选择：对于需要较强物理互动（如推箱子、被风吹动）的3D游戏，我会选择“力驱动”模式，并花时间调优参数。对于强调精准平台跳跃的2D或2.5D游戏，“速度覆盖”或“运动学”模式可能更可控。Cocos Creator 社区也有一些优秀的第三方角色控制器资产，可以节省大量时间。

4.2 物理材质与交互

碰撞不仅仅是形状的相交，还涉及表面的摩擦和弹性。这就是物理材质（PhysicsMaterial）的作用。你可以为碰撞体指定一个物理材质，它定义了两个属性：

• 摩擦系数（Friction）：影响物体沿接触面滑动的难易程度。值高则像橡胶，难滑动；值低则像冰，易滑动。
• 恢复系数（Restitution）：即弹性。决定碰撞后能量保留的多少。值为0是完全非弹性碰撞（如泥巴砸墙）；值为1是完全弹性碰撞（理想情况下的超级弹球）。

当两个不同材质的物体碰撞时，引擎通常会取用它们摩擦力和弹性的某种平均值（如几何平均）来计算最终效果。合理使用物理材质，可以轻松模拟出冰面、橡胶球、毛绒布等不同质感。

4.3 性能优化黄金法则

物理计算是CPU密集型操作，不当的使用会导致帧率骤降。请牢记以下法则：

1. 精简碰撞体形状：能用简单形状（盒、球、胶囊），绝不用复杂形状（网格）。一个复杂的网格碰撞体的计算开销可能是简单盒子的数十倍甚至上百倍。对于复杂模型，可以用多个简单碰撞体拼接来近似其形状。
2. 善用刚体类型：将永远不会移动的物体（地形、建筑）设置为Static。静态刚体在物理世界中被视为背景，物理引擎对其优化程度最高。动态刚体数量是性能的主要瓶颈。
3. 控制动态刚体数量：屏幕上同时活动的动态刚体最好控制在几十个以内。对于大量的小型物理对象（如一堆碎石），考虑使用简化的粒子系统或仅在必要时才启用其物理属性。
4. 使用碰撞分组与掩码：这是最强大也最容易被忽视的优化手段。不是所有物体都需要互相检测碰撞。例如，子弹不需要和子弹碰撞，远处的敌人不需要和玩家碰撞。在项目设置 -> 物理 -> 碰撞矩阵中，你可以定义不同的分组（如 ‘Default’， ‘Player’， ‘Enemy’， ‘Bullet’， ‘Item’），并精确配置哪些分组之间需要检测碰撞。这能直接减少物理引擎需要处理的碰撞对数量，性能提升立竿见影。
5. 适时休眠（Sleeping）：动态刚体在静止一段时间后，物理引擎会将其置为“休眠”状态，不再对其进行详细的模拟计算，直到它再次被外力唤醒。确保你的物理场景允许刚体休眠，可以大幅减少持续运算开销。

4.4 常见问题排查与调试技巧

1. 物体抖动或穿透（Z-fighting）：

   • 原因：两个碰撞体表面完全重合或极度接近，物理引擎在每一帧计算接触点时产生微小差异，导致视觉上的抖动。
   • 解决：避免让碰撞体表面完全对齐。在建模或摆放时，让它们之间有微小的重叠（如0.01个单位）或间隙。对于静态地形和动态物体，确保动态物体的碰撞体略高于地面一点点。

2. 高速物体穿透（子弹打不中）：

   • 原因：在单次物理更新步长内，物体移动的距离超过了其自身尺寸。物理引擎检测碰撞是基于离散的时间点，如果速度太快，可能从A点直接“跳”到了B点，中间没有检测到与障碍物的碰撞。
   • 解决：
     • 启用连续碰撞检测（CCD）：在动态刚体组件上，将useCCD属性设为true。这会显著增加计算量，所以只对少数高速物体（如子弹、发射物）启用。
     • 使用射线检测：对于子弹，更常见的做法是根本不使用物理碰撞体。而是每帧从枪口发射一条射线（physicsSystem.raycast），检测击中的物体。这种方式性能极好且绝对精确。

3. 物理表现不一致（不同帧率下行为不同）：

   • 原因：物理模拟在fixedUpdate中以固定时间步长运行，而游戏逻辑可能在波动的update中。如果在update中施加力或速度，会因为帧率不同而导致累计的力/冲量不同。
   • 解决：所有直接操作刚体力、速度、位置的代码，尽量放在fixedUpdate方法中。如果必须在update中处理，则需要根据时间增量（deltaTime）进行补偿计算。

4. 如何可视化调试碰撞体：

   • 在 Cocos Creator 编辑器的场景视图上方，有一个“调试显示”按钮组。点击物理调试按钮（通常是一个小立方体图标），可以在场景中看到所有碰撞体的线框轮廓。静态刚体通常显示为蓝色，动态刚体显示为绿色，触发器可能显示为半透明或红色。这是调试碰撞体位置、大小和类型是否正确的最直观工具。

物理系统的学习和掌握是一个实践出真知的过程。从最简单的方块下落开始，逐步尝试组合不同的刚体属性、碰撞体形状和物理材质，观察它们的行为。多利用调试工具，勤于查阅官方文档和社区案例。当你能够熟练地运用刚体和碰撞体，让游戏世界中的物体按照你设定的物理规则自然、稳定地互动时，你所创造的游戏体验将获得质的飞跃。记住，好的物理系统是让玩家沉浸其中却感觉不到它存在的幕后英雄。