Go Decimal 怎样用 RoundBank 实现银行家舍入

Go Decimal 的银行家舍入直接调用 Decimal.RoundBank(places)：当被舍弃部分正好位于两个候选值的中间时，保留最后一位偶数。金额先用 NewFromString 解析，计算结果再调用 RoundBank(2)，最后用 StringFixed(2) 输出固定两位。这样既不会把“中点取偶数”误写成普通四舍五入，也能保持金额展示格式稳定。

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

• 输入：用字符串读取十进制金额，避免先经过二进制浮点数。
• 计算：把舍入策略放在结算边界，使用 RoundBank(2)。
• 输出：用 StringFixed(2) 保留两位显示，不把显示格式当成计算规则。

先把金额结算目标说清楚

这个小项目模拟一条最小结算链：读取订单金额，计算折后金额，把结果舍入到两位小数，再输出给对账或接口层。重点不是把 Decimal 的所有 API 都讲一遍，而是让“原始值、舍入规则、展示字符串”三层职责分开。

银行家舍入也叫 round half to even。比如保留一位小数时，5.45 的中间位是 4，结果为 5.4；5.55 的中间位是 5，结果为 5.6。非中点仍按最近值处理，所以 5.46 为 5.5。它适合需要减少大量中点数据系统性偏差的场景，但前提是业务确实要求这种规则。

准备一个最小 Go 结算项目

创建目录并安装依赖。Decimal 官方文档提供了模块导入路径，本文只使用冻结标题涉及的 RoundBank 舍入任务。

# 创建一个独立目录，避免把示例混入已有模块
mkdir decimal-roundbank-demo
cd decimal-roundbank-demo

# 初始化 Go 模块并添加十进制库
go mod init example.com/decimal-roundbank-demo
go get github.com/shopspring/decimal

如果项目已有 go.mod，只需在项目目录执行依赖安装命令。不要为了改变舍入结果去修改全局配置；本例的规则通过一次明确的方法调用表达。

用 RoundBank 完成两位小数结算

下面的程序把金额从字符串解析为 Decimal，折扣计算仍保持十进制值，只有在结算输出边界调用 RoundBank(2)。解析错误直接返回，避免把无效金额静默当成零。

package main

import (
    "fmt"

    "github.com/shopspring/decimal"
)

// settleMoney 在结算边界执行银行家舍入，places=2 表示保留两位小数。
func settleMoney(raw string, discount string) (string, error) {
    // 用字符串解析金额，避免先转成 float64 再丢失十进制信息。
    amount, err := decimal.NewFromString(raw)
    if err != nil {
        return "", fmt.Errorf("解析金额失败: %w", err)
    }
    rate, err := decimal.NewFromString(discount)
    if err != nil {
        return "", fmt.Errorf("解析折扣失败: %w", err)
    }

    // Decimal 方法返回新的值，不修改原始 amount；折后金额在此统一舍入。
    factor := decimal.NewFromInt(1).Sub(rate)
    settled := amount.Mul(factor).RoundBank(2)

    // StringFixed 只负责固定展示两位，不改变已经确定的舍入策略。
    return settled.StringFixed(2), nil
}

func main() {
    // 使用字符串输入，便于金额、折扣和错误边界都可追踪。
    total, err := settleMoney("19.995", "0.10")
    if err != nil {
        fmt.Println("结算失败:", err)
        return
    }
    fmt.Println("折后金额:", total)
}

这里的 places 是保留的小数位数。传入 2 表示保留两位；传入负数则会舍入整数部分，例如官方源码示例中的 545.RoundBank(-1) 得到 540，因为舍入到十位时中点取偶数。

中点、负数和展示格式怎么验收

可以把边界样例集中放在一个小函数中。为了突出规则，下面只保留一位小数：5.45 的候选值是 5.4 和 5.5，偶数候选为 5.4；5.55 的偶数候选为 5.6。

func showBankerCases() {
    cases := []string{"5.45", "5.46", "5.55", "-5.45", "545", "546"}
    for _, raw := range cases {
        // RequireFromString 适合示例中的已知常量；外部输入仍应使用 NewFromString 检查错误。
        value := decimal.RequireFromString(raw)
        fmt.Printf("%s -> %s\n", raw, value.RoundBank(1).StringFixed(1))
    }
}

负数仍遵循距离和偶数规则，不能简单理解成“永远向上”或“永远远离零”。而 RoundBank 返回的是 Decimal，StringFixed(2) 只是把结果格式化为两位小数；如果只调用 String()，末尾的零可能按库设置被省略。

把舍入规则放进结算边界

实际项目可以保留三条约束：第一，金额输入优先用字符串解析；第二，所有进入对账、开票或持久化的金额统一走一个结算函数；第三，测试至少覆盖“刚好中点、略大于中点、负数、整数位舍入和解析失败”。这样调用方不需要各自猜测舍入策略。

不要把 RoundBank 和 StringFixedBank 混为一谈：前者返回舍入后的 Decimal，适合继续计算；后者返回已经按银行家舍入并固定小数位的字符串，适合展示。Decimal 的方法不会修改原值，折扣计算和最终舍入也可以保持清晰的中间变量。

常见问题

RoundBank(2) 是不是普通四舍五入？

不是。只有被舍弃部分正好处于两个候选值中间时，它才选择最后一位为偶数的结果；非中点仍取最近值。

为什么金额要用 NewFromString？

字符串能直接表达十进制输入，避免先转成二进制浮点数。外部请求、数据库文本或表单金额都应检查 NewFromString 返回的错误。

只想要两位字符串，可以直接用什么？

可以使用 StringFixedBank(2)。如果后面还要继续加减乘除，先保留 Decimal 并调用 RoundBank(2)，最后一步再格式化。