Go Decimal 怎样用 DivRound 为除法指定小数位数

我在处理单价、数量和分摊金额时，最容易踩到的坑不是不会做除法，而是除法精度被藏在全局配置里：同一份代码换了调用场景，结果的小数位就不够直观。Go Decimal 的 DivRound 适合把这个决定放回当前调用点。

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

要让一次除法保留指定的小数位，直接调用 result := left.DivRound(right, precision)。例如 10 ÷ 3 传入 2，得到数值上的 3.33；最后要不要补齐显示位数，再交给 StringFixed。

先判断默认 Div 是否适合当前值班场景

Div 的精度来自包级变量 DivisionPrecision，默认值是 16。这个设置适合一组调用都遵循同一策略的场景，但在结算、报价或报表导出里，我更愿意让精度和业务动作挨在一起。这样排查某个结果时，不需要先去找程序启动阶段有没有改过全局配置。

DivRound 的第二个参数是 precision int32。它表达的是结果保留几位小数，而不是总有效数字位数。比如传入 2，目标单位就是 0.01；传入 0，结果按整数粒度舍入。

把输入和精度放在同一个处理动作里

金额类输入优先从字符串构造 Decimal，避免先经过 float64。下面这段示例把除数、精度和格式化输出分开写，值班时能很快定位“数值不对”还是“展示不对”。

package main

import (
    "fmt"

    "github.com/shopspring/decimal"
)

func main() {
    // 从字符串读取十进制输入，避免金额先经过二进制浮点数。
    total, err := decimal.NewFromString("10")
    if err != nil {
        panic(err)
    }
    count, err := decimal.NewFromString("3")
    if err != nil {
        panic(err)
    }

    // precision=2 表示按 0.01 的粒度进行除法舍入。
    average := total.DivRound(count, 2)

    // String() 输出数值的紧凑形式，StringFixed() 控制展示位数。
    fmt.Println(average.String())      // 预期输出：3.33
    fmt.Println(average.StringFixed(2)) // 预期输出：3.33
}

这个调用返回的是新的 Decimal，不会把 total 或 count 改成结果。对我来说，这一点很重要：同一份原始金额后面还要做别的计算时，不会因为一次格式化除法把输入变量“变掉”。

遇到 5 时，先记住它是远离 0 舍入

官方文档对 DivRound 的边界说得很明确：正商的 5 向上舍入，负商的 5 向下舍入，方向都是远离 0。不要把它和银行家舍入混用。对于折扣、分摊或负数冲正，最好在需求说明里直接写出这个规则。

package main

import (
    "fmt"

    "github.com/shopspring/decimal"
)

func main() {
    // 正数在半数边界上远离 0：1.25 保留 1 位得到 1.3。
    positive := decimal.RequireFromString("1.25").DivRound(decimal.NewFromInt(1), 1)

    // 负数同样远离 0：-1.25 保留 1 位得到 -1.3。
    negative := decimal.RequireFromString("-1.25").DivRound(decimal.NewFromInt(1), 1)

    fmt.Println(positive.String()) // 预期输出：1.3
    fmt.Println(negative.String()) // 预期输出：-1.3
}

这里用 RequireFromString 只是为了让示例保持紧凑；真实接口接收外部输入时，我会保留 NewFromString 的错误处理，不让格式异常直接变成 panic。

负 precision 是整位舍入，不是错误码

文档允许传入负的 precision。可以把它理解成向小数点左侧移动舍入粒度：-1 对应 10 的倍数，-2 对应 100 的倍数。这个能力适合金额汇总后的粗粒度分档，但不适合拿来代替显示格式化。

package main

import (
    "fmt"

    "github.com/shopspring/decimal"
)

func main() {
    // precision=-1 把结果舍入到 10 的倍数，适合粗粒度分档。
    amount := decimal.RequireFromString("126").DivRound(decimal.NewFromInt(1), -1)
    fmt.Println(amount.String()) // 预期输出：130
}

如果你的业务要求的是“展示成两位小数”，就传正的 2，并在输出处调用 StringFixed(2)。负精度影响的是 Decimal 的数值结果，不是给字符串补零的开关。

发布前按这张表复查精度和展示

我通常会把 precision 定义成有名字的业务常量，并在测试用例里覆盖正数、负数、刚好整除和 5 的边界。这样代码评审时能看出舍入规则，而不是只看到一个裸数字。

相关问题

• DivRound 会改变原来的 Decimal 吗？ 不会，调用返回新的 Decimal，原操作数仍可继续使用。
• 为什么结果是 3.3 而不是 3.30？ 这是字符串展示策略；需要固定两位时使用 StringFixed(2)。
• 能不能用全局 DivisionPrecision 替代 DivRound？ 可以统一控制 Div，但单次调用有不同精度时，DivRound 更直接。
• 负 precision 能不能用来做金额格式化？ 它改变的是数值舍入粒度，金额展示通常应该使用正精度和 StringFixed。