Go big.Rat 怎样按指定格式输出分数

我在把精确计算结果写进日志和接口响应时，最容易踩到的坑不是算错，而是“显示格式”和“数值语义”混在了一起。Go 的 math/big.Rat 本身保存的是有理数，输出时可以继续保留分数，也可以只为阅读方便转换成固定小数位。

RatString() 适合保留精确的 a/b 语义；FloatString(prec) 适合展示固定的小数位。后者会按指定精度舍入，输出的十进制文本不一定还能还原原来的精确分数。

官方文档：https://pkg.go.dev/math/big#Rat.RatString

先把 RatString 和 String 分开

big.Rat 表示任意精度的有理数。RatString 在分母不为 1 时返回 a/b，分母为 1 时直接返回整数；String 则始终按 a/b 形式返回，即使这个数实际上是整数。

package main

import (
	"fmt"
	"math/big"
)

func main() {
	// 用整数分子和分母创建精确的 7/12，不先经过 float64。
	r := new(big.Rat).SetFrac64(7, 12)
	whole := new(big.Rat).SetFrac64(8, 4)

	// RatString 在分母为 1 时会省略 /1，便于面向读者展示。
	fmt.Println(r.RatString())
	fmt.Println(whole.RatString())

	// String 始终保留分子/分母结构，适合结构化调试输出。
	fmt.Println(whole.String())
}

FloatString 的 prec 是小数点后位数

FloatString(prec) 的参数只控制小数点后的位数。例如 prec=3 就是保留三位小数，不是“总共保留三位有效数字”。整数也会补齐小数位，所以它适合表格、报表和需要列宽统一的文本。

package main

import (
	"fmt"
	"math/big"
)

func main() {
	values := []struct {
		name string
		r    *big.Rat
	}{
		{"八分之一", new(big.Rat).SetFrac64(1, 8)},
		{"三分之一", new(big.Rat).SetFrac64(1, 3)},
		{"负五分之八", new(big.Rat).SetFrac64(-5, 8)},
	}

	for _, item := range values {
		// prec=3 表示小数点后固定三位，循环小数会发生舍入。
		fmt.Printf("%s: %s\n", item.name, item.r.FloatString(3))
	}
}

这段代码的展示结果可以按下面的语义理解：1/8 会得到 0.125，1/3 会得到 0.333，-5/8 在三位小数下是 -0.625。官方定义是“最后一位按最近值舍入，正好位于中点时远离零”，因此不要把 FloatString 当作截断函数。

精确分数和展示小数不要互相替代

一个实用的判断是：只要后续还要继续计算、比较或落库，就保留 *big.Rat；只有在日志、报表、用户界面或导出文本中需要统一外观时，才在最后一步调用 FloatString。这样可以避免把展示阶段的舍入误当成计算结果。

package main

import (
	"fmt"
	"math/big"
)

func formatRate(rate *big.Rat, decimals int) string {
	// 业务层显式传入展示位数，计算层仍保留原始 Rat。
	if decimals 

如果接口协议要求“最多两位小数”而不是“固定两位小数”，就不能直接把 FloatString(2) 当成通用格式化器，因为它会输出 2.00 这样的尾随零。此时可以把精确值和展示字符串分成两个字段，或在明确舍入规则后再做尾零处理。

写在最后：按输出目的选方法

• 需要可逆、可核对的分数：使用 RatString()。
• 需要始终显示分子与分母：使用 String()。
• 需要固定小数位：使用 FloatString(prec)，并把它视为舍入后的展示文本。
• 需要继续计算：保留 *big.Rat，不要先转换成 float64。

相关问题

为什么 FloatString 会出现尾随零？ 因为 prec 是固定的小数点后位数，补零是格式契约的一部分。

怎么判断十进制输出是否精确？ 可以使用 FloatPrec() 获取有限小数所需的位数和是否精确；如果只指定较小的 prec，则应按舍入文本处理。

能不能把 RatString 结果直接当作金额格式？ 不建议。金额展示通常需要明确小数位、舍入模式和尾零规则，应在业务边界单独封装。