Go math/big.Float Text 输出为何受格式参数影响

如果 math/big.Float.Text 输出和预期不一样，通常不是高精度数值被改了，而是 format 与 prec 共同决定了字符串的形状。e、f、g、x 会采用不同的计数方式；其中 g 的精度是总有效数字，不能按“小数点后几位”去理解。

先把同一个 *big.Float 当成固定数值，再分别选择输出格式：需要固定小数位用 f，需要科学计数法用 e，需要在定点和指数之间自动选择用 g。prec 只影响文字表示，不会改写 Float 的值。

先分清 Float 的值和 Text 的参数

big.Float 保存的是带有二进制尾数精度的高精度浮点值，而 Text 做的是一次格式化转换：它读取当前值，按照 format 和 prec 生成字符串。把输出从 f 改成 e，不会让数值重新计算，也不会改变 Prec() 返回的尾数精度。

可以把这两个参数看成一张小关系图：format 选择“定点、指数还是十六进制”，prec 决定“要展示多少位”。只有先分开这两层，看到末尾补零、指数变化或有效数字减少时，才不会误以为 Float 被截断了。

同一个数换格式，变化的是字符串外形

下面固定一个带 80 位尾数精度的数，分别观察四种常用格式。代码里的注释说明了每个参数的目的，打印结果只用于展示格式差异。

package main

import (
	"fmt"
	"math/big"
)

func main() {
	// 先固定数值和尾数精度，后面的 Text 调用只改变展示方式。
	x, ok := new(big.Float).SetPrec(80).SetString("12345.6789")
	if !ok {
		// 输入不是完整的浮点文本时，不能继续把 x 当成有效结果。
		panic("invalid floating-point text")
	}

	// e 使用指数形式，prec 表示小数点后的位数。
	fmt.Println("e:", x.Text('e', 4))
	// f 使用定点形式，prec 同样表示小数点后的位数。
	fmt.Println("f:", x.Text('f', 2))
	// g 在定点和指数形式之间选择，prec 表示总有效数字。
	fmt.Println("g:", x.Text('g', 6))
	// x 使用十六进制尾数和二的幂指数，prec 是小数点后的十六进制位数。
	fmt.Println("x:", x.Text('x', 4))
}

对这个输入，e 会呈现类似 1.2346e+04 的指数形式，f 会保留两位小数，g 会围绕六位有效数字做紧凑表示，而 x 会变成十六进制尾数加二进制指数。重点是：四次调用读取的是同一个 x，差别来自格式化规则和舍入展示。

g 的精度为什么和 f 不一样

最常见的误读是把 x.Text('g', 6) 当成“保留小数点后六位”。实际上 g/G 的 prec 是总数字位数，整数部分已经占用的数字也要算进去。因此对 12345.6789 使用 g 的精度 6，结果可能是六位有效数字的紧凑写法，而不是六位小数。

相反，f 的精度只描述小数点后保留多少位。需要报表列对齐时，优先选择 f；需要让很大或很小的值自动切换指数时，再用 g。不要只凭输出长度判断精度，先看调用中使用了哪一个 format。

负精度以及 b、p 要单独记

当 prec 为负数时，Text 会选择足以根据当前 Float 的尾数精度唯一标识该值的最小十进制位数。这适合希望字符串重新解析后仍能区分原值的场景，但它不等同于固定的“小数点后 -1 位”，也不适合作为界面列宽规则。

b 和 p 是二的幂指数形式，并且忽略 prec。b 输出十进制整数尾数与二的幂指数，p 输出十六进制尾数与二的幂指数；它们更适合诊断二进制表示，而不是面向普通用户的金额或报表文本。

package main

import (
	"fmt"
	"math/big"
)

func main() {
	// 负精度让库自行选择足以唯一标识当前值的十进制位数。
	x := new(big.Float).SetPrec(64).SetFloat64(1.0 / 3.0)
	fmt.Println("short:", x.Text('g', -1))

	// b 和 p 的 prec 参数没有作用，传入 0 只是为了表达这一点。
	fmt.Println("binary-mantissa:", x.Text('b', 0))
	fmt.Println("hex-mantissa:", x.Text('p', 0))
}

如果这类输出用于协议或缓存键，建议把格式和精度写进接口约定，不要依赖 String() 的默认选择。官方文档说明 String() 等价于 Text('g', 10)；它适合快速查看，不一定适合需要稳定列格式的业务数据。

String、fmt 和无效格式的边界

big.Float 实现了 fmt.Formatter，所以 fmt.Printf 的浮点格式也可以参与展示，但格式字符的语义仍应回到 Text 的规则理解。要明确生成字符串时，直接调用 Text 更容易让代码审查者看出位数约定。

传入未支持的格式字符时，Text 返回一个带百分号的标记，例如未知字符 q 会得到类似 %q 的结果。这不是合法的数值文本；如果输出要交给解析器，应先限制 format 集合，再把格式错误作为配置问题处理。

最后按用途选择参数

固定小数展示选择 f，指数展示选择 e，紧凑且允许自动切换选择 g，排查二进制尾数选择 x、b 或 p。然后再决定 prec 是小数位、总有效数字，还是由负值自动推导。这样即使输出发生变化，也能明确知道变化来自格式参数，而不是误判为 big.Float 的数值状态被修改。