旋转铰链关节的本质是限制两刚体仅绕指定轴相对转动并禁止平移及其他轴旋转，其物理约束通过约束方程实现，需依赖Bullet等引擎的HingeConstraint封装，关键在锚点重合、局部坐标系下轴对齐及求解器参数调优。
什么是旋转铰链关节的物理约束本质
旋转铰链关节不是“让物体转起来”，而是限制两个刚体只能绕指定轴相对转动，同时阻止平移和绕其他轴的旋转。它在物理引擎中表现为一组约束方程，求解器需在每帧迭代中满足这些方程——C++ 里直接手写完整约束求解器不现实，真正可行路径是基于成熟物理库（如 Bullet、PhysX 或 Box2D）封装或配置 HingeConstraint。
Bullet 中 BtHingeConstraint 的关键初始化参数
用 Bullet 实现时，最容易出错的是坐标系对齐和参考帧设置。它不接受“世界轴”直接输入，而是依赖两个刚体的局部坐标系与锚点共同定义旋转轴：
-
btHingeConstraint(rigidBodyA, rigidBodyB, pivotInA, pivotInB, axisInA, axisInB)：其中pivotInA和pivotInB是各自刚体局部坐标系下的锚点位置，必须先确保两刚体初始姿态下这些点重合，否则关节会“拉扯” -
axisInA和axisInB是各自刚体局部坐标系下的单位向量，代表铰链轴方向；若两者不平行，Bullet 会自动取axisInA为实际约束轴，并将axisInB投影对其——但初始角度偏差大会导致约束不稳定 - 调用
setLimit(lowAngle, highAngle)才启用角度限制；默认不限制，即 0–2π 自由旋转
为什么 setLimit() 后关节仍可能“穿透”或抖动
这不是代码写错了，而是 Bullet 默认求解精度和迭代次数不足以稳定处理硬限位。常见表现是物体撞到限位角后轻微穿出、回弹震荡：
- 在
btSequentialImpulseConstraintSolver中，增加求解迭代数：solverInfo.m_numIterations = 100（默认 10） - 启用软限位而非硬限位：
hinge->enableAngularMotor(false); hinge->setLimit(low, high, softness, biasFactor, relaxationFactor)，其中biasFactor控制恢复速度（推荐 0.3–0.6），relaxationFactor缓冲超调（推荐 1.0） - 避免在刚体质量差异过大时使用铰链（如 1kg 连接 1000kg）；质量比超过 100:1 时，小质量端易失控，应改用
btGeneric6DofConstraint并锁定多余自由度
绕世界 Z 轴旋转的典型误操作
很多人想“让门绕世界 Z 轴开合”，直接传入 btVector3(0,0,1) 给 axisInA，结果门乱转。这是因为 axisInA 是刚体 A 的局部坐标系下的向量，而刚体 A 初始朝向未必与世界对齐：
立即学习“C++免费学习笔记（深入）”；
- 正确做法：先获取刚体 A 的当前世界变换
rigidBodyA->getWorldTransform()，用其旋转部分将世界轴转到局部空间：axisInA = worldTransform.getBasis().inverse() * btVector3(0,0,1) - 更稳妥的方式是：把铰链轴定义在刚体 A 的建模坐标系中（比如门模型自身 Z 向就是转轴），导出时保证该轴与期望世界轴一致，后续不再动态计算
- 调试时可用
hinge->getHingeAngle()检查当前角度，但注意该值在未收敛帧中可能跳变，应在btDynamicsWorld::stepSimulation()后读取
铰链约束的稳定性高度依赖初始配置精度和求解器参数，而不是逻辑分支多少；一个没对齐的 pivotInA 比十个 if 判断更容易让整个系统发散。
