Go Decimal Decimal 的 Equal 和结构体相等比较有什么区别

我在把金额对象放进表格、缓存和测试断言时，最容易被一个细节绊住：两个 Decimal 打印出来一样，结构体用 == 却不一定相等。结论先说清楚：Decimal.Equal 判断的是数值，结构体 == 判断的是各字段的 Go 值表示；业务金额比较通常应该调用 Equal，不要把结构体 == 当成数值比较的替代品。

官方地址：https://pkg.go.dev/github.com/shopspring/decimal

Decimal.Equal 内部走 Cmp，会处理指数不同但数值相同的情况；包含 Decimal 的结构体使用 == 时，会继续比较 Decimal 的内部指针和指数，以及结构体里的其它字段。

先把“相等”拆成三种问题

排查失败断言时，我会先问比较目标是哪一种：

• 数值相等：1.2 与 1.20 是否代表同一个金额？用 Equal。
• 对象表示相等：两个 Decimal 是否由同一份内部对象、相同指数构成？这是结构体 == 可能碰到的语义。
• 业务对象相等：金额、币种、订单状态等字段是否都满足业务条件？需要逐字段定义，而不是直接套一个运算符。

这三种目标不能混在一起。打印字符串只能说明格式化结果相同，不能证明内部表示相同；而结构体相等也不能替代金额的数值语义。

Decimal.Equal 为什么比结构体 == 更适合金额

Decimal 的实现包含一个 *big.Int 系数指针和一个 int32 指数。源码中的 Equal 直接返回 d.Cmp(d2) == 0，而 Cmp 会在指数不同的时候按十进制位对齐后再比较。

package main

import (
    "fmt"

    "github.com/shopspring/decimal"
)

func main() {
    a := decimal.RequireFromString("1.2")
    b := decimal.RequireFromString("1.20")

    // Equal 关注实际数值，而不是字符串的小数位数。
    fmt.Println(a.Equal(b)) // true

    // Cmp 适合需要区分小于、等于、大于的判断。
    fmt.Println(a.Cmp(b)) // 0
}

这里的关键不是输出格式，而是比较路径：Equal 先进入数值比较，指数不同时会做等价的位数对齐。对于金额、税率和折扣等业务值，这正是通常想要的语义。

结构体 == 比较的陷阱在哪里

只要结构体的所有字段都可比较，Go 就允许使用 ==。Decimal 本身的字段类型是指针和整数，所以它在语言层面可比较；但指针字段比较的是地址，不是指针指向的 big.Int 数值。

package main

import (
    "fmt"

    "github.com/shopspring/decimal"
)

type Quote struct {
    Amount decimal.Decimal
    Unit   string
}

func main() {
    left := Quote{
        Amount: decimal.RequireFromString("1.2"),
        Unit:   "CNY",
    }
    right := Quote{
        Amount: decimal.RequireFromString("1.20"),
        Unit:   "CNY",
    }

    // 业务字段相同，但 Decimal 的内部表示不是数值比较契约。
    fmt.Println(left == right) // 可能为 false

    // 金额字段使用数值语义，其余字段再按业务规则比较。
    sameQuote := left.Unit == right.Unit && left.Amount.Equal(right.Amount)
    fmt.Println(sameQuote) // true
}

“可能为 false”来自两层表示差异：1.2 与 1.20 往往有不同的系数和指数；即使数值和指数恰好相同，分别构造的 Decimal 也可能持有不同的 *big.Int 地址。只有简单赋值复制同一个 Decimal 值时，指针地址才可能保持一致，但这属于别名结果，不应当被当成金额相等规则。

按排查现象选择比较方式

遇到断言失败时，可以按下面的顺序缩小范围：

1. 先比较 Decimal.Equal：如果它为真，说明金额数值相同，问题多半在结构体的其它字段或错误使用了 ==。
2. 再比较 Exponent 和格式：如果业务要求固定两位小数，比较相等之后用 StringFixed(2) 生成展示值，不要拿展示字符串承担全部业务判断。
3. 最后检查零值：零值 Decimal 可用，但它和显式构造的零值可能有不同内部表示；金额判断仍使用 Equal(decimal.Zero) 或 IsZero。
4. 需要排序时用 Cmp：不要把 Equal 与大于、小于拼成容易遗漏边界的表达式，直接根据 Cmp 的 -1、0、1 处理。

测试和代码评审的最终清单

• 金额字段是否用 Equal，而不是直接用结构体 ==？
• 是否把币种、状态、精度策略等非金额字段单独比较？
• 是否把 String() 的尾零裁剪和数值相等混为一谈？
• 是否把 Decimal 放进含 slice、map 或函数字段的结构体后仍然尝试使用 ==？这类结构体本身不可比较。

我在实际代码里会把“金额相等”封装成业务方法，让调用方不用了解 *big.Int 和指数细节；只有确实要判断整个对象的表示一致性时，才考虑结构体级别的比较。这样测试失败时，证据会直接告诉你是金额、格式，还是其它业务字段出了问题。

相关问题

Decimal 的 Equals 和 Equal 有什么区别？

当前文档将 Equals 标记为 deprecated，它会转调 Equal。新代码直接使用 Equal。

为什么不能用打印出来的字符串判断金额？

字符串受尾零和全局格式设置影响，展示格式相同或不同都不等于你已经明确了数值比较规则。