四元数Slerp路径陷阱

概述

四元数 q 和 -q 代表相同的3D旋转。Slerp(q1, q2, t) 根据点积符号选择插值路径：点积为正取短路径，点积为负取长路径（超过180度），导致物体旋转方向反向。

关键内容

问题现象

在3D游戏中使用硬编码四元数配合Slerp做朝向插值时，物体转向会交替出现180度反向： - 第1次转向：正常 - 第2次转向：反向180° - 第3次转向：正常（如此循环）

根本原因

1. 四元数双重覆盖 - q 和 -q 表示同一3D旋转 - Slerp(q1, q2, t) 的路径由 dot(q1, q2) 决定： - dot > 0 → 选短路径（正确） - dot < 0 → 选长路径，即绕行超过180°（错误）

2. 硬编码四元数缺乏连续性 不同方向的硬编码四元数之间，点积符号不可预测，导致Slerp路径随机选择长/短路径。

错误示例（Lua/UrhoX）

-- 错误：为每个方向硬编码四元数
if direction.z > 0 then
    target = Quaternion(90, Vector3(1, 0, 0))   -- dot = 0.5（运气好，短路径）
elseif direction.x > 0 then
    target = Quaternion(90, Vector3(0, 0, 1))   -- dot可能为负 → 长路径 → 反向！
end
local newRot = currentRot:Slerp(target, speed * dt)

修复：手动保证点积为正

若无法避免硬编码，可在插值前修正符号：

if currentRot:DotProduct(targetRot) < 0 then
    targetRot = -targetRot  -- 取等价四元数，保证短路径
end

根本解法

见方向向量动态旋转计算 — 使用 atan2 从方向向量动态推算旋转，天然保证连续性，彻底规避此陷阱。

高层API替代

若引擎支持，优先使用高层API（自动处理路径问题）：

node:LookAt(targetPosition, Vector3.UP)
-- 或
local rot = Quaternion.LookRotation(direction, Vector3.UP)

来源

snake-head-rotation-flip — 3D贪吃蛇蛇头旋转180度反向完整案例分析（2025-11-24）