Havok Physics C++集成需先获商业授权并构建SDK生成静态库；必须注册hkMemoryRouter分配器、正确创建刚体与形状、在独立线程中调用stepDeltaTime，并注意引用计数与线程安全。
Havok Physics 的 C++ 集成前提：别跳过授权和构建步骤
Havok 不是开箱即用的开源库，必须先从 Havok Developer Center 申请商业授权并下载 SDK（通常为 havok_2023.1.0 这类版本号命名的压缩包）。未获授权或直接 GitHub 搜 “havok” 找到的所谓“开源版”基本是旧 demo 或伪造包，链接会直接失效或编译报 HK_FAILURE。
下载后需运行 BuildWin64.bat（Windows）或 build_linux.sh（Linux），生成 Libs/Win64/Release 下的 Common.lib、Physics2012.lib 等静态库——这些才是你项目里要链接的真实目标。漏掉这步，#include <Common/Base/hkBase.h> 能过，但链接时必报 LNK2001: unresolved external symbol hkVector4::setZero。
常见错误现象：
- 头文件能包含，但
hkArray<int> arr;编译失败：没加HK_CONFIG_SIMD=1宏，或没定义HK_PLATFORM_WIN32 - CMake 找不到
hkBase.h：路径写成include/Havok而非解压后实际的Source/Common/Base - 运行时报
hkError::report：没调用hkBaseSystem::init()，或内存分配器未注册
初始化与内存管理：hkMemoryRouter 是绕不开的硬要求
Havok 强制接管所有内部内存分配，不设自定义分配器就崩溃。不能只写 hkBaseSystem::init(); 就完事，必须显式绑定 hkMemoryRouter。
立即学习“C++免费学习笔记（深入）”；
实操建议：
- 定义全局静态分配器，比如继承
hkMemoryAllocator写个简易MyHeapAllocator，重载blockAlloc/blockFree - 在
main()开头立即调用hkMemoryRouter::getInstance().setDefaultAllocator(&myAllocator); - 务必在
hkBaseSystem::init()之前完成分配器注册，否则初始化过程自身就会触发未定义行为 - 游戏主循环结束前调用
hkBaseSystem::quit();，否则hkReferencedObject的析构可能访问已释放内存
忘记这一步最典型的错误是：物理世界创建成功，但第一次调用 world->stepDeltaTime(1.0f/60.0f) 就触发断点，堆栈停在 hkContainerHeapAllocator::allocateBlock。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
创建刚体和碰撞体：hkRigidBody 和 hkShape 的典型组合
Havok 的刚体不是直接 new 出来的对象，而是由 hkWorld 管理的资源；形状（hkShape）必须通过 hkShapePhantom 或 hkRigidBodyCinfo 关联，不能裸指针传入。
示例关键代码片段：
hkWorld* world = new hkWorld(hkWorldCinfo()); world->markForWrite(); // 必须加锁才能添加刚体 <p>hkSphereShape* sphere = new hkSphereShape(1.0f); hkRigidBodyCinfo info; info.m_shape = sphere; info.m_mass = 1.0f; info.m_position.set(0.0f, 5.0f, 0.0f);</p><p>hkRigidBody* body = new hkRigidBody(info); world->addEntity(body); // 自动接管生命周期 sphere->removeReference(); // shape 引用计数减一，否则泄漏
注意点：
-
hkSphereShape、hkBoxShape等都是引用计数对象，new后必须配对removeReference()，否则hkWorld::stepDeltaTime()期间会因引用残留导致崩溃 - 动态刚体需设
m_mass > 0，静态物体（如地面）设m_mass = 0并确保m_motionType = HK_MOTION_FIXED - 若用
hkConvexVerticesShape表示自定义网格，顶点数组必须满足凸性，否则碰撞检测结果不可靠
步进物理世界与同步：不要在渲染线程直接调用 stepDeltaTime
hkWorld::stepDeltaTime() 是重计算函数，含大量 SIMD 运算和内部锁，直接塞进 OpenGL/Vulkan 渲染循环会导致帧率抖动甚至死锁。
推荐做法：
- 单独开一个物理线程（或使用 job system），固定时间步长调用
stepDeltaTime(1.0f/60.0f) - 刚体变换数据通过
hkRigidBody::getMotionState()->m_transform获取，但该矩阵在 step 过程中可能被写入，需用hkWorld::lock() / unlock()保护读取 - 避免每帧都
getTransform()：缓存上一帧 transform，仅当body->isAwake()为 true 时才更新，静止物体可跳过同步 - 多线程下切忌把
hkRigidBody*指针直接扔给渲染系统——应拷贝hkTransform到线程安全缓冲区
最容易被忽略的是：Havok 默认启用 HK_ENABLE_DETERMINISM，这会让浮点运算强制走标量路径，性能下降 30%+。若不需要跨平台回放一致性，应在预编译宏中关闭它。
