Go x/text/number MinFraction 与 MaxFraction 为什么要配套设置

Go 的 golang.org/x/text/number 里，MinFractionDigits 和 MaxFractionDigits 并不是“必须同时传入”的成对参数，但在业务输出需要稳定时，通常应该把它们当成一组约束来设计：前者规定小数位下限，后者规定上限。只有把上下限一起想清楚，补零、舍入和 Locale 带来的显示差异才不会混在一起。

官方资料：https://pkg.go.dev/golang.org/x/text/number

固定显示几位小数时直接使用 number.Scale(n)；允许一个小数位范围时同时设置 MinFractionDigits(min) 和 MaxFractionDigits(max)；只有确实需要单侧约束时才只设置其中一个。

先确认触发信号：是小数位规则，不是浮点数变了

排查这类问题时，常见现象是同一个数在不同页面显示成 1.2、1.20 或 1.200，也可能发现较长的小数在输出时被截短。先不要急着怀疑输入值被修改，number.Decimal 负责的是格式化，Options 影响的是“怎样呈现”。

官方包把数字格式化交给 Formatter，而 MinFractionDigits 和 MaxFractionDigits 都是配置 formatter 的 Option。前者的语义是最少保留多少位小数，后者的语义是最多保留多少位小数。它们控制同一条显示轴上的两个端点。

把两个小数位边界拆开

MinFractionDigits 负责下限

当输入的小数位少于下限，格式化结果需要补足显示位。例如设置 MinFractionDigits(2) 后，1.2 的展示目标会变成至少两位小数，通常可看到 1.20。它解决的是“不要显得位数不齐”的问题，不负责限制最多能出现几位。

MaxFractionDigits 负责上限

MaxFractionDigits(3) 表示小数部分最多显示三位。输入精度超过这个上限时，formatter 需要按自己的舍入规则生成不超过上限的结果。它解决的是“不要把过长小数直接展示出来”的问题，但单独设置它并不等于输出永远有三位小数。

因此，Min=2 与 Max=3 表达的是一个清晰范围：结果可以是两位或三位，但不会少于两位，也不会超过三位。所谓“配套设置”，重点就在于明确这个范围，而不是 API 层面强制两个函数必须同时出现。

快速判断：你需要固定精度还是可变精度

把需求分成三类，选择会更快：

金额、税率和固定报表列通常属于第一类；测量值、比例和用户输入的可读展示经常属于第二类；临时日志或不要求对齐的自然语言输出，才适合考虑第三类。

用 Scale 表达固定小数位

官方文档明确说明，Scale(decimals) 会同时设置 MinFractionDigits 和 MaxFractionDigits。所以固定两位时，下面的写法比手动传两个 Option 更直接：

package main

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

func main() {
    p := message.NewPrinter(language.English)

    // Scale(2) 同时设置小数位下限和上限，适合固定两位的报表值。
    p.Println(number.Decimal(12.5, number.Scale(2)))
}

这里的关键不是把输入值改成两位，而是让 formatter 按固定精度呈现。需要改变 Locale 时，替换 language.English 或使用对应语言标签；不要用字符串拼接自己补零和插入分隔符。

用 Min 与 Max 表达一个可变范围

如果业务允许一到三位小数，范围写法更能表达意图：

package main

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

func main() {
    p := message.NewPrinter(language.English)

    // 下限负责可读性，上限负责控制展示长度；两者合起来就是输出契约。
    optionMin := number.MinFractionDigits(1)
    optionMax := number.MaxFractionDigits(3)
    p.Println(number.Decimal(1.2, optionMin, optionMax))
    p.Println(number.Decimal(1.2345, optionMin, optionMax))
}

第一行体现“至少一位”，第二行体现“最多三位”。如果页面还要求列宽一致，就不要只凭感觉增加 Min；先确认产品到底要固定精度，还是只允许一个范围。

为什么只设置一侧容易留下误会

只传 MinFractionDigits(2) 是合法的，它表达“至少两位”；只传 MaxFractionDigits(2) 也有用，它表达“最多两位”。问题在于，另一个端点没有在代码里出现，接手的人很难一眼判断这是有意的默认行为，还是漏传了一个 Option。

例如金额场景只设置最少两位，输入有更多小数时，是否允许展示三位、四位，要看其他格式设置和默认策略；只设置最多两位，则 1 可能仍然显示为 1 而不是 1.00。如果业务合同是“永远两位”，单侧设置就不能准确表达它，应改成 Scale(2)。

处理步骤：按这条顺序定位显示不一致

1. 记录原始数值语义。先确认它是金额、比例、测量值还是普通计数，避免把业务精度和展示精度混为一谈。
2. 列出上下限。明确“最少几位、最多几位”，如果两个答案都能说清，就优先把两个边界写进 Option。
3. 检查是否应使用 Scale。固定小数位直接改用 Scale(n)，不要手写两个相同的数字。
4. 检查 Locale。数字分组符和小数分隔符可能随语言变化，比较问题时固定同一个 language.Tag。
5. 再看舍入。只有确认上下限和 Locale 都正确后，才判断长小数在上限处的舍入结果。

回滚路径：先恢复明确的显示契约

线上出现小数位忽长忽短时，可以先把临时配置收敛为固定精度，例如报表金额统一使用 Scale(2)，让页面恢复可预测输出。之后再根据产品要求改回范围设置。这个回滚只改变展示规则，不会把已经存储的原始数值改成字符串。

如果问题只发生在某一种语言环境，优先保留输入和 formatter 配置，单独替换 language.Tag 做对照；不要在排障时同时修改数值、Locale 和舍入策略。

告警确认与复盘项

• 确认相同输入是否使用了同一组 MinFractionDigits、MaxFractionDigits 或 Scale。
• 确认页面比较的是格式化后的字符串，还是原始数值。
• 确认是否把“补零”误认为输入精度被改变，把“上限舍入”误认为数据丢失。
• 确认测试样例覆盖整数、短小数、超过上限的小数和不同 Locale。

复盘时把格式契约写成一句可读的话，例如“英文环境下最多三位、至少一位”，再让代码中的 Option 与这句话一一对应，后续修改就不容易漏掉另一侧边界。

常见问题

MinFractionDigits 和 MaxFractionDigits 必须同时设置吗？

不必须。它们是两个独立的 Option；只是当输出需要稳定时，同时表达下限和上限更容易维护。

固定两位小数应该怎么写？

优先写 number.Scale(2)，因为它的语义就是同时设置两个边界。

MaxFractionDigits 会把原始数据截断吗？

它控制 formatter 的显示结果，不等于修改存储值。要区分页面字符串、日志文本和真正写回数据库的数值。