3D旋转逻辑异常：绕Z轴旋转后Y值不符合预期

核心错误：旋转计算中的变量覆盖 #

你的代码在绕Z轴（roll）旋转时，错误地使用了更新后的x值计算y，而非旋转前的原始x值，这直接导致了Y值的偏差。

具体计算验证

以测试点(10,10,0)绕Z轴30度旋转为例：

• 正确的绕Z轴旋转公式：

  x_new = x_old * cos(30°) - y_old * sin(30°)
  y_new = x_old * sin(30°) + y_old * cos(30°)
  

  代入数值后，正确结果为：
  x_new ≈ 10*0.8660 -10*0.5 = 3.660，y_new ≈10*0.5 +10*0.8660=13.6602

• 你的代码执行逻辑：

  x = x * Math.cos(roll) - y * Math.sin(roll); // x被更新为3.660
  y = x * Math.sin(roll) + y * Math.cos(roll); // 用新x=3.660计算，得到≈1.83+8.66=10.49
  

  第二步计算y时，使用的是已经修改后的x，而非原始的x=10，这就是Y值不符合预期的根本原因。

延伸隐患：其他旋转步骤的同类问题 #

不仅绕Z轴的步骤，绕X轴（pitch）和Y轴（yaw）的旋转也存在相同的变量覆盖问题：

• 绕X轴时，计算z用了更新后的y，而非原始y；
• 绕Y轴时，计算z用了更新后的x，而非原始x；
  这些问题在单轴旋转参数为0时不会暴露，但多轴组合旋转时会导致严重偏差。

修复方案 #

旋转计算时必须保留当前步骤的原始坐标值，通过临时变量存储中间结果，避免覆盖正在使用的变量。修复后的代码示例：

public void rotate3d(double pitch, double roll, double yaw) {
  pitch *= RADIANS_PER_DEGREE; // 0.01745
  roll *= RADIANS_PER_DEGREE;
  yaw *= RADIANS_PER_DEGREE;

  // 保存初始坐标
  double xOld = x;
  double yOld = y;
  double zOld = z;

  // 1. 绕X轴旋转（pitch）
  double yPitch = yOld * Math.cos(pitch) - zOld * Math.sin(pitch);
  double zPitch = yOld * Math.sin(pitch) + zOld * Math.cos(pitch);
  double xPitch = xOld;

  // 2. 绕Y轴旋转（yaw）
  double xYaw = xPitch * Math.cos(yaw) + zPitch * Math.sin(yaw);
  double zYaw = zPitch * Math.cos(yaw) - xPitch * Math.sin(yaw);
  double yYaw = yPitch;

  // 3. 绕Z轴旋转（roll）
  x = xYaw * Math.cos(roll) - yYaw * Math.sin(roll);
  y = xYaw * Math.sin(roll) + yYaw * Math.cos(roll);
  z = zYaw;
}

该方案通过每一步的临时变量存储旋转结果，确保计算时始终使用正确的输入值，无论单轴还是多轴旋转都能得到准确结果。

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