企业官网建设流程全解析

1. 项目概述：为什么我们需要亲手整合一个物理引擎？

如果你是一名C++开发者，尤其是对游戏、仿真、动画或者任何需要模拟现实世界物体运动的领域感兴趣，那么“物理引擎”这个词对你来说一定不陌生。市面上有成熟的方案，比如Bullet、Box2D、PhysX，直接拿来用不香吗？为什么还要费劲从零开始整合？这正是这个项目的核心价值所在。它不是一个简单的API调用教程，而是一次从底层理解物理模拟，到工程化整合，再到性能调优的完整实战。通过这个过程，你收获的将不仅仅是一个能跑起来的物理模块，而是对刚体动力学、碰撞检测、约束求解等核心概念的深刻理解，以及如何将一套复杂的第三方C++库优雅、高效地嵌入到自己的项目架构中。这对于提升你的系统设计能力、性能优化嗅觉和解决复杂工程问题的能力，是任何现成教程都无法替代的。

简单来说，这个项目适合两类人：一是希望深入理解物理引擎原理，不满足于“黑盒”使用的开发者；二是正在为自己的游戏或仿真项目寻找物理解决方案，但面临性能、定制化或集成难题的工程师。我们将从最基础的数学和物理概念开始，逐步搭建一个可用的物理世界，然后引入一个成熟的物理引擎（比如Bullet）进行深度整合，最后聚焦于上线前必须面对的优化挑战。整个过程，我会穿插大量我踩过的坑和总结出的实战技巧。

2. 核心架构与设计思路拆解

在动手写第一行代码之前，我们必须想清楚整个系统的架构。一个整合良好的物理引擎，不应该是一个孤立的、难以驾驭的“怪物”，而应该像血液循环系统一样，自然地融入你的整个应用躯体。

2.1 物理世界与游戏世界的分离与同步

这是第一个，也是最重要的设计决策。你的游戏世界里有一套逻辑：角色位置、状态机、动画播放。物理世界则完全是另一套基于牛顿定律的模拟系统。最糟糕的做法是把这两套逻辑混在一起，比如直接修改物理刚体的位置来响应游戏逻辑，这会破坏物理模拟的连续性，导致各种诡异的穿透、抖动问题。

正确的思路是主从架构。游戏逻辑是“主”，物理模拟是“从”。在每一帧：

1. 从（物理）到主（游戏）：物理引擎完成一步模拟（stepSimulation）后，我们从物理刚体中读取最新的变换（位置、旋转），将其同步到游戏世界中对应的视觉对象或逻辑对象上。这是数据流动的主要方向。
2. 从（物理）到主（游戏）：物理引擎检测到的碰撞事件，通过回调函数通知游戏逻辑层，触发受伤、播放音效、得分等游戏性反应。
3. 主（游戏）到从（物理）：当游戏逻辑需要施加一个力、改变速度（比如角色跳跃、被击中击飞）时，通过调用物理引擎的API（如applyCentralForce,setLinearVelocity）来影响物理世界，而不是直接设置位置。

这种分离保证了物理模拟的独立性和稳定性。你的架构中应该有一个清晰的PhysicsSystem类，它封装了物理世界的创建、销毁、步进和查询，并对外提供干净的接口供游戏逻辑调用。

2.2 数据结构的映射与生命周期管理

物理引擎中的刚体（btRigidBody）、碰撞形状（btCollisionShape）、约束（btTypedConstraint）等对象，都需要与你的游戏对象（GameObject、Entity）建立关联。这里的关键是所有权和生命周期。

一种常见且推荐的做法是，让PhysicsSystem或每个游戏对象自己，持有其对应物理对象的智能指针（如std::unique_ptr）。当游戏对象被销毁时，其对应的物理对象也必须从物理世界中移除并销毁。切记，物理引擎内部通常也有一套内存管理，你需要调用正确的删除函数（如delete btRigidBody），而不是简单地delete一个原始指针，因为物理对象可能由引擎的内存池分配。

我强烈建议为你的游戏对象设计一个PhysicsComponent组件。这个组件在构造时创建物理刚体和形状，在析构时负责清理。这样符合组件化设计，也便于通过像EnTT这样的ECS架构进行管理。

2.3 单位制与坐标系的统一

混乱的单位和坐标系是物理模拟“玄学”bug的主要来源。物理引擎内部通常使用国际单位制（SI）：米（m）、千克（kg）、秒（s）。而你的游戏可能为了方便，使用“单位”或“厘米”作为长度单位。

必须在项目一开始就强制统一。我的经验是：让游戏逻辑适配物理引擎的单位制。即，在游戏内部，1个单位长度就代表1米。这样，你传递给物理引擎的尺寸参数（如盒子半长宽高）就无需转换。重力加速度设为-9.8f就代表 -9.8 m/s²，非常直观。如果你已有的游戏资产是基于其他单位的，那么需要在加载模型时进行一次性缩放转换。

坐标系同样重要。常见的3D图形API（如OpenGL）使用右手坐标系，Y轴向上。而一些物理引擎（如Bullet）默认使用右手坐标系，但Z轴向上。你必须明确你的整个项目使用哪个坐标系，并在物理世界初始化时进行配置（Bullet可以通过设置全局轴向标识来调整），在从物理世界读取数据传递给渲染层时，可能需要进行坐标转换（例如，交换Y和Z分量并处理方向）。忽略这一点，物体会在你意想不到的平面上运动或旋转。

3. 从零搭建：基础物理世界的构建

在引入大型物理引擎前，我们先徒手搭建一个最简化的物理世界，这能帮你夯实概念。我们将实现两个核心：运动积分和基础的碰撞检测。

3.1 质点运动与数值积分

我们从最简单的质点开始。一个质点的状态由其位置pos和速度vel描述。根据牛顿第二定律，加速度a = F / m。在连续时间里，速度是位置的导数，位置是速度的积分。但计算机是离散的，我们通过数值积分来近似。

最常用的是显式欧拉法，虽然不精确但易于理解：

void integrateExplicitEuler(Vec3& pos, Vec3& vel, const Vec3& acc, float deltaTime) { vel += acc * deltaTime; // 更新速度：v = v0 + a * dt pos += vel * deltaTime; // 更新位置：p = p0 + v * dt }

注意，这里先更新速度再用新速度更新位置。一个更稳定、更常用的方法是速度Verlet积分或半隐式欧拉法（Symplectic Euler），它在游戏物理中更常见：

void integrateSymplecticEuler(Vec3& pos, Vec3& vel, const Vec3& acc, float deltaTime) { vel += acc * deltaTime; // 用当前加速度更新未来速度 pos += vel * deltaTime; // 用未来速度更新位置 }

注意：deltaTime是帧间时间差。为了保证模拟稳定性，尤其是当帧率波动时，必须使用固定的时间步长进行物理更新。通常做法是累积真实流逝时间，每次固定步进（如1/60秒）更新一次物理，可能一帧内更新多次。这就是“固定时间步长”循环，是稳定物理模拟的基石。

3.2 基础碰撞检测：AABB与球体

没有碰撞的物理世界是不完整的。我们实现两种最简单的形状：轴对齐包围盒（AABB）和球体。

AABB碰撞：判断两个AABB是否相交，只需检查它们在三个轴上的投影区间是否重叠。

struct AABB { Vec3 min; Vec3 max; }; bool intersectAABB(const AABB& a, const AABB& b) { return (a.max.x > b.min.x && a.min.x < b.max.x) && (a.max.y > b.min.y && a.min.y < b.max.y) && (a.max.z > b.min.z && a.min.z < b.max.z); }

球体碰撞：判断两个球体是否相交，只需检查球心距离是否小于半径之和。

struct Sphere { Vec3 center; float radius; }; bool intersectSphere(const Sphere& a, const Sphere& b) { Vec3 diff = a.center - b.center; float dist2 = diff.dot(diff); // 距离平方 float radiusSum = a.radius + b.radius; return dist2 <= radiusSum * radiusSum; // 比较平方避免开方 }

检测到碰撞后，最简单的响应是直接反转速度（弹性碰撞）或将速度置零（完全非弹性）。但这非常粗糙。真实的碰撞响应需要计算碰撞法线、冲量，并考虑质量和恢复系数（弹性）。这涉及到线性代数和物理公式，复杂度急剧上升。这也正是我们需要成熟物理引擎的原因——它们已经高效、稳定地实现了这些复杂算法。

4. 整合成熟物理引擎：以Bullet为例

当基础概念清晰后，我们引入Bullet Physics库。它是一个功能强大、开源且广泛应用于游戏和电影工业的物理引擎。

4.1 环境配置与项目集成

首先，你需要获取Bullet库。推荐从GitHub克隆源码进行编译，这样你可以获得调试符号，并在必要时修改代码。

Windows (Visual Studio) 集成步骤：

1. 使用CMake生成Visual Studio解决方案。勾选BUILD_SHARED_LIBS可以构建DLL，但为了部署简单，我通常静态链接（/MT或/MTd）。
2. 编译后，你会得到BulletCollision.lib,BulletDynamics.lib,LinearMath.lib等库文件。
3. 在你的项目属性中：
   • C/C++ -> 附加包含目录：添加Bullet的src目录。
   • 链接器 -> 附加库目录：添加编译出的库文件目录。
   • 链接器 -> 输入 -> 附加依赖项：添加上述的.lib文件名。
4. 确保你的项目运行时库（/MT,/MTd,/MD,/MDd）与编译Bullet时使用的设置一致，否则会导致链接错误。

跨平台与CMake集成（推荐）：如果你的项目使用CMake，集成会优雅得多。你可以使用add_subdirectory将Bullet源码作为子目录加入，或者使用find_package查找已安装的Bullet。前者更简单，能确保版本一致。

# 在你的CMakeLists.txt中 add_subdirectory(thirdparty/bullet3) # 假设bullet源码在此目录 target_link_libraries(YourTarget PRIVATE Bullet3::BulletDynamics Bullet3::BulletCollision Bullet3::LinearMath)

这样，CMake会自动处理包含路径和库依赖。

4.2 核心对象创建与关联

整合的第一步是创建物理世界并填充物体。

1. 创建物理世界：

#include <btBulletDynamicsCommon.h> // 碰撞配置和分配器 btDefaultCollisionConfiguration* collisionConfiguration = new btDefaultCollisionConfiguration(); btCollisionDispatcher* dispatcher = new btCollisionDispatcher(collisionConfiguration); btBroadphaseInterface* overlappingPairCache = new btDbvtBroadphase(); btSequentialImpulseConstraintSolver* solver = new btSequentialImpulseConstraintSolver; btDiscreteDynamicsWorld* dynamicsWorld = new btDiscreteDynamicsWorld( dispatcher, overlappingPairCache, solver, collisionConfiguration); // 设置重力（假设Y轴向上，负方向为重力方向） dynamicsWorld->setGravity(btVector3(0, -9.8f, 0));

这四个对象（配置、分发器、宽相、求解器）是Bullet世界的基石。btDiscreteDynamicsWorld是你主要交互的接口。

2. 创建刚体：一个刚体由碰撞形状、运动状态和物理属性构成。

// 1. 创建碰撞形状（例如一个盒子，半长宽高各1米） btCollisionShape* groundShape = new btBoxShape(btVector3(btScalar(50.), btScalar(1.), btScalar(50.))); // 2. 创建运动状态，定义初始变换 btTransform groundTransform; groundTransform.setIdentity(); groundTransform.setOrigin(btVector3(0, -1, 0)); // 放在Y=-1的位置 btDefaultMotionState* myMotionState = new btDefaultMotionState(groundTransform); // 3. 设置刚体构造信息 btRigidBody::btRigidBodyConstructionInfo groundRigidBodyCI( 0, // 质量，0表示静态物体 myMotionState, groundShape, btVector3(0, 0, 0) // 局部惯性，静态物体为0 ); // 4. 创建刚体并加入世界 btRigidBody* groundRigidBody = new btRigidBody(groundRigidBodyCI); dynamicsWorld->addRigidBody(groundRigidBody);

对于动态物体，质量大于0，并且需要计算正确的惯性张量：

btCollisionShape* fallShape = new btSphereShape(btScalar(1.)); btScalar mass = 1.0f; btVector3 fallInertia(0, 0, 0); fallShape->calculateLocalInertia(mass, fallInertia); // 关键！计算惯性 btTransform fallTransform; fallTransform.setIdentity(); fallTransform.setOrigin(btVector3(0, 50, 0)); btDefaultMotionState* fallMotionState = new btDefaultMotionState(fallTransform); btRigidBody::btRigidBodyConstructionInfo fallRigidBodyCI( mass, fallMotionState, fallShape, fallInertia); btRigidBody* fallRigidBody = new btRigidBody(fallRigidBodyCI); dynamicsWorld->addRigidBody(fallRigidBody);

3. 关联游戏对象：Bullet允许你为每个刚体设置一个用户指针void* userPointer。这是关联游戏对象的关键。

class GameObject { /* ... */ }; GameObject* myGameObj = new GameObject(...); fallRigidBody->setUserPointer(myGameObj);

之后，在碰撞回调或查询时，你可以通过rigidBody->getUserPointer()取回你的游戏对象，进行逻辑处理。

4.3 游戏循环与物理步进

物理更新必须与渲染循环解耦。使用固定时间步长。

float fixedTimeStep = 1.0f / 60.0f; // 60Hz物理更新 float maxSubSteps = 10; // 最大子步数，防止“螺旋死亡” float accumulator = 0.0f; float deltaTime; // 上一帧的真实时间 // 在游戏主循环中 accumulator += deltaTime; if (accumulator > fixedTimeStep * maxSubSteps) { accumulator = fixedTimeStep * maxSubSteps; // 防止累积过多，避免卡死 } while (accumulator >= fixedTimeStep) { // 1. 处理输入和逻辑，对物理世界施加力/冲量 processInputAndApplyForces(); // 2. 执行一步物理模拟 dynamicsWorld->stepSimulation(fixedTimeStep, maxSubSteps); // 3. 同步物理状态到游戏对象 syncPhysicsToGameObjects(); accumulator -= fixedTimeStep; } // 可选：在物理更新次数之间进行渲染插值，使运动更平滑 float interpolationFactor = accumulator / fixedTimeStep; renderWithInterpolation(interpolationFactor);

stepSimulation的第二个参数是最大子步数。如果accumulator大于fixedTimeStep，Bullet会尝试进行多次子步进来“追赶”时间，但最多不超过maxSubSteps次。这保证了在帧率短暂骤降时物理模拟不会失控。

4.4 碰撞检测与响应

Bullet提供了多种方式获取碰撞信息。

1. 遍历接触点（Manifold）：每一帧模拟后，你可以遍历所有碰撞对。

int numManifolds = dynamicsWorld->getDispatcher()->getNumManifolds(); for (int i = 0; i < numManifolds; i++) { btPersistentManifold* contactManifold = dynamicsWorld->getDispatcher()->getManifoldByIndexInternal(i); const btCollisionObject* obA = contactManifold->getBody0(); const btCollisionObject* obB = contactManifold->getBody1(); GameObject* objA = static_cast<GameObject*>(obA->getUserPointer()); GameObject* objB = static_cast<GameObject*>(obB->getUserPointer()); int numContacts = contactManifold->getNumContacts(); for (int j = 0; j < numContacts; j++) { btManifoldPoint& pt = contactManifold->getContactPoint(j); if (pt.getDistance() < 0.0f) { // 距离为负表示穿透 // 获取碰撞点、法线、冲量等信息 btVector3 ptA = pt.getPositionWorldOnA(); btVector3 ptB = pt.getPositionWorldOnB(); btVector3 normal = pt.m_normalWorldOnB; // 从B指向A的法线 // 触发游戏逻辑：造成伤害、播放声音等 if (objA && objB) { objA->onCollision(objB, ptA, normal, -pt.m_appliedImpulse); // 注意冲量方向 objB->onCollision(objA, ptB, -normal, pt.m_appliedImpulse); } } } }

2. 使用碰撞回调（btCollisionWorld::ContactResultCallback）：对于更复杂的查询（如射线检测、形状重叠检测），Bullet提供了回调机制。例如，射线检测：

struct MyRayResultCallback : public btCollisionWorld::RayResultCallback { GameObject* hitObject = nullptr; btVector3 hitPointWorld; btVector3 hitNormalWorld; virtual btScalar addSingleResult(btCollisionWorld::LocalRayResult& rayResult, bool normalInWorldSpace) { // 找到最近的碰撞 if (rayResult.m_collisionObject) { hitObject = static_cast<GameObject*>(rayResult.m_collisionObject->getUserPointer()); hitPointWorld = rayResult.m_hitPointLocal; if (normalInWorldSpace) { hitNormalWorld = rayResult.m_hitNormalLocal; } else { // 需要转换法线到世界空间 } return rayResult.m_closestHitFraction; // 返回击中分数，用于排序 } return 1.0f; // 未击中 } }; MyRayResultCallback callback; btVector3 rayFrom(0, 10, 0); btVector3 rayTo(0, -10, 0); dynamicsWorld->rayTest(rayFrom, rayTo, callback); if (callback.hasHit()) { // 处理击中逻辑 }

5. 性能优化与上线调优

一个能跑起来的物理demo和一個能在复杂游戏场景中稳定运行60帧的物理系统，中间隔着巨大的优化鸿沟。以下是上线前必须关注的优化点。

5.1 宽相过滤与碰撞形状优化

物理模拟的瓶颈通常在碰撞检测，尤其是窄相检测（精确形状相交测试）。宽相（Broadphase）的目标是快速排除明显不会碰撞的物体对，减少窄相的工作量。

• 选择合适的宽相算法：Bullet默认的btDbvtBroadphase（动态AABB树）对动态物体多的场景很好。对于大量静态物体，可以考虑btAxisSweep3（轴向扫描）。在项目初始化时根据场景特点选择。
• 碰撞分组与掩码：不是所有物体都需要互相检测。通过addRigidBody的重载版本设置碰撞过滤组和掩码。

  short groupGround = 1; short groupPlayer = 2; short groupEnemy = 4; short groupProjectile = 8; // 地面只与玩家和敌人碰撞 dynamicsWorld->addRigidBody(groundBody, groupGround, groupPlayer | groupEnemy); // 子弹只与敌人碰撞 dynamicsWorld->addRigidBody(bulletBody, groupProjectile, groupEnemy); // 玩家和敌人互相碰撞，也与地面碰撞 dynamicsWorld->addRigidBody(playerBody, groupPlayer, groupEnemy | groupGround);

  这能极大减少不必要的碰撞检测。
• 简化碰撞形状：渲染用的高模网格绝不能直接用作碰撞形状。必须使用简化的凸包（btConvexHullShape）、胶囊体（btCapsuleShape）、盒子（btBoxShape）或复合形状（btCompoundShape）来近似。对于复杂静态场景，使用btBvhTriangleMeshShape（静态三角网格）。Bullet提供了工具（如btShapeHull）可以从网格生成凸包近似。

5.2 多线程与异步模拟

物理模拟是CPU密集型任务。Bullet支持多线程碰撞检测和约束求解。

• 启用并行调度器：使用btCollisionDispatcherMt替代默认的btCollisionDispatcher。
• 使用并行求解器：使用btSequentialImpulseConstraintSolverMt。
• 注意数据竞争：多线程下，在物理步进过程中，不要从其他线程访问或修改刚体状态。所有对物理世界的操作（添加/移除物体、施加力）都应在主线程或同步到主逻辑线程中进行。物理步进本身可以放在独立线程，但同步数据需要小心。

一个更实用的模式是异步物理更新：将物理模拟放在一个独立的线程中，以固定的时间步长运行。游戏逻辑线程通过线程安全的队列向物理线程发送指令（施加力、生成物体），物理线程每完成一步，将刚体的变换数据写入一个共享的、双缓冲的数据结构中，供渲染线程读取。这能有效利用多核，防止物理模拟卡住主线程。但实现复杂度较高，需要精细的同步。

5.3 内存管理与对象池

频繁创建和销毁物理对象（如子弹、特效碎片）会导致内存碎片和性能抖动。

• 对象池：为频繁使用的刚体、形状、运动状态预分配一个池。当游戏对象“死亡”时，不是立即删除其物理组件，而是将其标记为“禁用”（setActivationState(DISABLE_SIMULATION)）并放回池中。新对象需要时从池中取出并重新初始化。这避免了频繁的new/delete和物理世界的添加/移除操作。
• 形状共享：多个相同尺寸的刚体（如一批相同的子弹）可以共享同一个碰撞形状实例。因为碰撞形状通常是无状态的（除了尺寸数据），且只读，共享是安全的，能节省大量内存。

  btCollisionShape* sharedBulletShape = new btSphereShape(0.5f); // 多个刚体构造信息都使用这个 sharedBulletShape

• 及时清理：当确定一个形状或刚体不再需要时，确保按照delete rigidBody; delete motionState; delete shape;的顺序正确删除。对于从物理世界移除的刚体，Bullet可能仍然持有引用，所以删除前务必调用dynamicsWorld->removeRigidBody(body)。

5.4 调试与性能剖析

上线前，必须进行彻底的性能分析和调试。

• Bullet调试绘制：Bullet内置了调试绘制接口，可以将碰撞形状、接触点、AABB等可视化。实现btIDebugDraw接口并将其设置给dynamicsWorld->setDebugDrawer(&yourDebugDrawer)。在调试版本中启用它，对于检查碰撞形状是否正确、物体是否按预期运动至关重要。
• 性能计数器：Bullet的btDynamicsWorld提供了getProfileInfo方法，可以获取碰撞检测、求解器等各阶段耗时。定期输出或记录这些数据，找到性能热点。
• 时间步长与子步数调优：fixedTimeStep和maxSubSteps需要权衡。更小的步长（如1/120秒）模拟更精确，但计算量更大。更大的步长性能更好，但可能导致快速运动物体穿透或模拟不稳定。对于大多数60FPS游戏，1/60秒是个不错的起点。maxSubSteps设得太高，在卡顿时会导致单帧内多次模拟，加剧卡顿；设得太低，可能导致模拟“丢帧”，物体运动变慢。需要根据游戏类型和性能预算调整。
• 激活状态管理：静止的物体（btRigidBody）会被Bullet置为“休眠”状态以节省计算。确保你的静态物体质量设为0，动态物体在静止一段时间后会自动休眠。对于需要被玩家或事件随时唤醒的物体，这是很好的优化。但注意，如果你每一帧都手动移动一个物体（即使速度为零），它会保持激活状态。对于大量受控角色，考虑使用运动学物体（btKinematicCharacterController）或设置适当的休眠阈值。

6. 常见问题与排查技巧实录

整合物理引擎的路上遍布荆棘，以下是我总结的一些典型问题及其解决方法。

6.1 物体抖动或穿透

这是最常见的问题之一。

• 原因1：时间步长不稳定。没有使用固定时间步长，或者deltaTime传递错误。
  • 排查：检查物理更新循环，确保stepSimulation使用的是固定的fixedTimeStep，并且使用了累积器模式。
• 原因2：形状太薄或太小。物理引擎对极端尺寸的物体处理不好。
  • 排查：检查碰撞形状的尺寸。避免使用厚度为0的平面（用薄盒子代替），避免尺寸小于0.01米的物体。可以适当放大碰撞形状。
• 原因3：恢复系数（弹性）太高且阻尼太低。导致物体在接触时不断弹跳，看起来像抖动。
  • 排查：调整刚体的setRestitution（恢复系数）和setDamping（线性/角速度阻尼）。对于大多数非弹性碰撞，恢复系数设为0.1-0.3，阻尼设为0.1-0.5。
• 原因4：质量比例悬殊。一个质量极大的物体与一个质量极小的物体碰撞，可能导致数值不稳定。
  • 排查：检查场景中物体的质量设置。尽量让动态物体之间的质量在一个合理的数量级内（如0.1到100之间）。静态物体质量应为0。

6.2 性能突然下降

• 排查1：碰撞对数量激增。使用调试绘制查看AABB，检查是否有大量物体聚集在一起，或者宽相过滤失效。优化碰撞分组掩码，简化复杂物体的碰撞形状。
• 排查2：内存碎片或泄漏。使用内存分析工具（如Visual Studio的诊断工具、Valgrind）检查是否有物理对象未被正确删除。确保遵循RAII原则或使用对象池。
• 排查3：单次模拟时间过长：可能是由于复杂的约束（如多个关节连接的 Ragdoll）或复杂的网格碰撞。考虑简化约束，或将静态三角网格替换为复合的凸包形状。
• 排查4：启用了不必要的特性：如连续碰撞检测（CCD）对快速移动的物体（如子弹）是必要的，但会显著增加开销。只为确实需要的物体启用（rigidBody->setCcdMotionThreshold(...)和setCcdSweptSphereRadius）。

6.3 碰撞事件丢失或不准确

• 排查1：回调未注册或注册错误。确保你正确实现了碰撞回调类（如btCollisionWorld::ContactResultCallback）并将其用于射线测试或contactTest。
• 排查2：接触点持久化问题。btPersistentManifold存储的是上一帧的接触信息。在模拟步进后立即遍历，才能拿到当前帧的结果。确保你在stepSimulation之后、下一次stepSimulation之前处理碰撞。
• 排查3：形状不匹配。渲染模型和碰撞形状严重不符，导致视觉上碰撞了但物理上没检测到，或者反之。用调试绘制将碰撞形状可视化，确保它们紧密贴合渲染模型。

6.4 链接与编译错误

• LNK2001/LNK2019 未解析的外部符号：这几乎总是因为链接的库不匹配。
  • 检查1：运行时库。确保你的项目属性C/C++ -> 代码生成 -> 运行时库与编译Bullet时使用的选项一致（/MT,/MTd,/MD,/MDd）。
  • 检查2：库文件路径和名称。确认附加依赖项中的.lib文件名完全正确，且路径已添加到附加库目录。
  • 检查3：32位/64位。确保你的项目平台（x86/x64）与编译的Bullet库平台一致。
• CMake找不到Bullet：如果使用find_package(Bullet)，需要确保Bullet已安装在CMake的搜索路径中，或者设置Bullet_ROOT变量指向Bullet的安装目录。

整合物理引擎是一个系统工程，涉及数学、物理、软件架构和性能优化多个层面。从理解基本原理开始，到谨慎地集成第三方库，再到为上线进行深度调优，每一步都需要耐心和细致的实践。最宝贵的经验往往来自于解决那些最棘手的bug。当你看到自己搭建的物理世界中的物体按照预想的规律运动、碰撞、坠落时，那种成就感是无可替代的。希望这份从零到上线的实战指南，能为你铺平道路，少踩一些我当年踩过的坑。记住，遇到问题时，调试绘制是你的第一双眼睛，性能分析器是你的第二双眼睛，而清晰的架构设计则是让你避免陷入泥潭的导航图。