Go x/text/number 显示舍入为什么不改变原始数值

Go golang.org/x/text/number 的“舍入”发生在格式化输出阶段，不会修改传入的整数、浮点数或其他业务值。Scale 用来固定显示小数位，IncrementString 用来指定显示时采用的增量；它们返回的是格式化器，业务变量仍然保持原来的数值。

官方地址：https://pkg.go.dev/golang.org/x/text/number

先分开原始数值和显示文本

很多“舍入没有生效”的误会，实际上是把两个结果混在了一起：一个是程序内继续参与计算的数值，另一个是交给读者看的字符串。number.Decimal 返回 number.Formatter，由 message.Printer 在输出时按照语言环境和选项组织文字；它没有把结果写回原变量。

下面的示例故意同时打印原始值和格式化结果。IncrementString("0.05") 是官方文档给出的典型用法，显示时把 1.44 变成 1.45，但变量 amount 仍然可以按 1.44 参与后续计算。

package main

import (
    "fmt"

    "golang.org/x/text/language"
    "golang.org/x/text/message"
    "golang.org/x/text/number"
)

func main() {
    // amount 是业务计算值；格式化只在输出时发生。
    amount := 1.44
    printer := message.NewPrinter(language.English)

    // IncrementString 只控制展示用的舍入增量。
    shown := number.Decimal(amount, number.IncrementString("0.05"))
    printer.Println("展示值:", shown)

    // 这里仍使用原始变量，说明格式化没有回写 amount。
    fmt.Printf("原始值参与计算: %.2f\\n", amount+1)
}

这段代码的两个输出通道职责不同：shown 是一个延迟到打印时才被解释的 Formatter，amount+1 仍按原始浮点值计算。图中的分层关系可以帮助排查“页面看起来变了，数据却没变”的现象。

用 Scale 或 IncrementString 指定显示舍入

如果需求是“固定显示几位小数”，优先看 Scale；如果需求是“按照 0.05、0.50 这样的步长显示”，使用 IncrementString。两者都是 Formatter 的 Option，服务于展示规则，不是通用的数值舍入函数。

package main

import (
    "golang.org/x/text/language"
    "golang.org/x/text/message"
    "golang.org/x/text/number"
)

func main() {
    // Printer 负责按语言环境输出格式化后的文字。
    printer := message.NewPrinter(language.English)
    amount := 12.3456

    // Scale 同时设置最小和最大显示小数位为 2。
    printer.Println("固定两位:", number.Decimal(amount, number.Scale(2)))

    // 增量舍入适合价格档位、计量刻度等展示规则。
    printer.Println("按五分显示:", number.Decimal(1.44, number.IncrementString("0.05")))
}

Scale(2) 影响的是格式化器对小数位的呈现；IncrementString 还会把显示 scale 设置为增量本身的 scale。要注意，二者不能替代业务层的金额模型、数据库精度策略或财务计算规则。若业务真的需要把结果四舍五入后继续参与计算，应明确创建新的业务数值并记录该转换，而不是把 Formatter 当成赋值操作。

把格式化结果放在输出边界

推荐的调用方式是：业务层保存并计算原始数值，适配展示的边界层才创建 Formatter。这样做能避免一个页面的显示规则悄悄影响库存、比例、阈值和排序。

在 Web 接口中，可以让响应模型保留数值字段，同时由前端或专门的呈现层生成显示文本；在邮件、命令行和报表中，则可以直接用 message.Printer 输出 Formatter。关键是把“给人看的结果”留在最后一跳。

用对照检查定位误解

遇到显示结果和预期不同，可以按下面顺序检查：第一，确认拿到的是 number.Formatter 还是已经被转换成字符串；第二，确认 Option 是 Scale 还是 IncrementString；第三，确认语言环境是否改变了分组符号和小数分隔符；第四，把原始变量单独打印，确认没有把展示文本重新解析后覆盖业务值。

最容易出错的是最后一步：为了保存“页面上的 1.45”，代码把格式化字符串反解析成数值再写回数据库。这已经是一次新的数据转换，不能归因于 x/text/number 自动修改了原始值。若确实需要这种业务转换，应单独命名、单独测试，并明确舍入规则。

• 只改变页面精度：使用 Scale 或 IncrementString 生成 Formatter。
• 需要继续计算：使用原始值，不要从展示文本反解析。
• 需要多语言显示：在输出边界使用对应的 language.Tag 和 message.Printer。
• 需要改变业务数据：显式创建新的数值转换流程，不把显示 Formatter 当成转换器。

常见问题

number.Decimal 会修改传入的 float64 吗？

不会。它创建的是 Formatter，选项用于组织输出；传入的数值变量不会因为显示舍入而被回写。

Scale(2) 和 IncrementString("0.05") 有什么区别？

Scale(2) 固定显示两位小数；IncrementString("0.05") 表达按五分增量显示，并同时带出增量的小数位尺度。

为什么页面显示 1.45，数据库还是 1.44？

这正是格式化层与数据层分离的表现。页面使用 Formatter 生成了展示文本，数据库仍保存原始业务值；只有显式执行新的数值转换并写回，数据库才会改变。