Swift 角度评估接近360度时行为异常，航向判断逻辑失效求助

Swift 提供的 Angle 类型本身支持任意正负实数的角度表示，不会自动将数值约束在 0°~360° 的圆周循环区间内：比如计算 2° - 3° 时，它会直接存储 -1° 的数值，不会自动折算为符合航行语义的 359°。
当起始航向接近 0°/360° 边界时，直接做角度差计算会得到负的边界值，此时原来基于线性大小的比较逻辑会完全失效：比如起始航向为 2° 时，计算得到的阈值分别为 -8°（起始-10°）、-3°（起始-5°），实际落在 352°~357° 区间的合法正航向值，因为数值远大于负数阈值，根本触发不了预设的判断分支，最终导致颜色显示错误。

Swift 中原生的取模运算符 % 仅支持整数类型运算，直接用在 Double 类型的角度值上，编译器就会抛出“运算符不支持浮点数类型”的警告。
此外普通数学取模的默认规则和圆周折算的需求也不完全匹配：很多实现对负数取模的结果仍然是负数（比如 -1° 取模 360 得到 -1° 而非预期的 359°），就算绕开语法问题，直接套用也很难一次得到正确的循环角度值。

第一步：实现通用的角度归一化能力 #

基于 Swift 给 Double 提供的 truncatingRemainder 方法（专门支持浮点数的余数计算，不存在 % 的类型兼容问题），封装一个归一化函数，不管输入是正角度、负角度、还是超过360°的角度，都统一折算到 0°~360° 的循环区间：

// 将任意角度值折算到 0° ~ 360° 的圆周区间
func normalizeHeading(_ value: Double) -> Double {
    let remainder = value.truncatingRemainder(dividingBy: 360)
    return (remainder + 360).truncatingRemainder(dividingBy: 360)
}

这个函数会自动把 -1° 折算为 359°、361° 折算为 1°，完全符合圆周角度的循环特性。

第二步：用相对差值替代绝对值比较 #

跨边界场景下，直接比较两个角度的绝对值天生存在逻辑缺陷，更稳定的方式是：先计算当前航向相对于起始航向的循环相对差值，把差值约束在 -180° ~ 180° 范围内，再基于差值做业务判断——这种方式完全不需要关心角度是否跨越 0°/360° 边界。
计算循环相对差值的逻辑非常简单：

// 相对差值永远取最短路径，范围固定在 -180° ~ 180°
let relativeDelta = normalizeHeading(currentHeading - startHeading + 180) - 180

举个实际场景验证：当起始航向为 2°、当前航向为 359° 时，原始差值为 357°，经过上面的计算会得到 -3°，完全匹配“当前航向比起始航向逆时针偏3°”的实际语义，不会出现边界错位。

第三步：替换原函数的判断逻辑 #

所有原有的业务规则完全保留，只是把直接对比两个Angle绝对值的部分，换成上面计算得到的相对差值做判断，修改后的完整可运行函数如下：

func lh1(startHeading: Double, currentHeading: Double) -> Color {
    // 内部封装角度归一化方法，避免和其他代码命名冲突
    func normalize(_ value: Double) -> Double {
        (value.truncatingRemainder(dividingBy: 360) + 360)
            .truncatingRemainder(dividingBy: 360)
    }
    // 计算跨边界安全的相对航向差值
    let relativeDelta = normalize(currentHeading - startHeading + 180) - 180
    
    var coloreDaMostrare: Color = .black
    // 完全沿用原业务判断规则
    if relativeDelta >= -10 && relativeDelta < -5 {
        coloreDaMostrare = .orange
    } else if relativeDelta > -5 {
        coloreDaMostrare = .black
    } else if relativeDelta < -10 {
        coloreDaMostrare = .orange
    }
    return coloreDaMostrare
}

方案优势 #

• 完全兼容所有角度场景，不管起始角度是大于10°的常规值，还是接近0°/360°的边界值，判断结果都一致
• 全部使用Swift原生语法，不存在取模运算符不支持Double类型的警告
• 没有改动原有业务的判断规则，只是从根源上规避了圆周角度的边界缺陷，不会引入新的逻辑错误

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