如何将(x,y,z,w)格式的四元数转换为轴角{[x,y,z], 角度（度数）}并获取[0-360°]范围的旋转角度？

没问题，我来帮你理清楚四元数转轴角的正确方法，这个转换有严谨的数学依据，咱们一步步拆解：

首先要明确游戏里用的旋转四元数都是单位四元数（模长为1），它的标准形式是：
q = cos(θ/2) + sin(θ/2) * (x*i + y*j + z*k)
其中：

• θ 是绕轴旋转的总角度（弧度）
• (x,y,z) 是单位向量，代表旋转轴的方向

从这个公式就能推导出准确的转换步骤：

1. 先确保四元数是单位化的 #

如果你的四元数因为计算误差模长不是1，先做归一化处理：

norm = sqrt(x² + y² + z² + w²)
x = x / norm
y = y / norm
z = z / norm
w = w / norm

（如果norm接近0，说明是零四元数，直接返回任意轴+0度即可）

2. 计算旋转角度（转成0-360°） #

从公式里的cos(θ/2) = w，可以反推出：

θ（弧度）= 2 * arccos(w)
θ（度数）= θ（弧度）* (180 / π)

为了确保角度严格落在0-360°范围内，最后对结果取模360即可：angle_deg = angle_deg % 360.0

这里要注意：浮点误差可能让w稍微超出[-1,1]范围，所以计算arccos前要把w钳制在[-1,1]之间，避免报错。

3. 计算旋转轴 #

从公式里的sin(θ/2) * (x,y,z)对应四元数的虚部，所以旋转轴的单位向量是：

axis_x = x / sin(θ/2)
axis_y = y / sin(θ/2)
axis_z = z / sin(θ/2)

如果θ接近0（也就是旋转角度极小），sin(θ/2)会接近0，这时候轴的计算会有精度问题，直接返回任意单位轴（比如(1,0,0)）就行。

import math

def quaternion_to_axis_angle(x, y, z, w):
    # 处理零四元数情况
    norm = math.sqrt(x**2 + y**2 + z**2 + w**2)
    if norm < 1e-6:
        return ([1.0, 0.0, 0.0], 0.0)
    
    # 归一化四元数
    x_normalized = x / norm
    y_normalized = y / norm
    z_normalized = z / norm
    w_normalized = w / norm

    # 计算角度（弧度转度数，钳制w避免浮点误差）
    clamped_w = max(min(w_normalized, 1.0), -1.0)
    angle_rad = 2 * math.acos(clamped_w)
    angle_deg = math.degrees(angle_rad)
    
    # 确保角度在0-360°范围
    angle_deg = angle_deg % 360.0

    # 计算旋转轴
    sin_half_angle = math.sin(angle_rad / 2)
    if abs(sin_half_angle) < 1e-6:
        # 角度接近0，返回默认轴
        return ([1.0, 0.0, 0.0], angle_deg)
    
    axis_x = x_normalized / sin_half_angle
    axis_y = y_normalized / sin_half_angle
    axis_z = z_normalized / sin_half_angle

    # 再次归一化轴（保险起见，避免浮点误差）
    axis_norm = math.sqrt(axis_x**2 + axis_y**2 + axis_z**2)
    axis_x /= axis_norm
    axis_y /= axis_norm
    axis_z /= axis_norm

    return ([axis_x, axis_y, axis_z], angle_deg)

• 游戏引擎里通常有内置函数（比如Unity的Quaternion.ToAngleAxis()），如果能用引擎自带的优先用，因为它们做了更多精度优化
• 当旋转角度接近180°时，轴的方向可能会有符号差异（比如(x,y,z)和(-x,-y,-z)对应相同的旋转效果），这是正常的，不影响使用

内容的提问来源于stack exchange，提问作者seriously