登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  Golang >  Go问答

Go math/big.Rat.Scan 的 %f 与 %v 为什么采用相同读取规则

来源:17golang原创

时间:2026-11-19 07:52:35 270浏览 收藏

如果你在 fmt.Fscanf 中分别使用 %f 和 %v 读取 math/big.Rat,会发现两种写法得到的结果相同。这不是 fmt 忽略了格式字符串,而是 *big.Rat 实现的 Scan 明确把这两个动词放进了同一个支持集合。

结论:Rat.Scan 接受 e、E、f、F、g、G 和 v,官方文档说明这些格式全部等价。%f 与 %v 在这里表达的是“怎样调用扫描接口”,不是“用浮点格式或默认格式改变 Rat 的数值”。

官方资料:https://pkg.go.dev/math/big#Rat.Scan

先区分扫描动词和输出动词

同一个百分号动词出现在输入和输出场景时,语义不能直接类比。输出时,%f 通常表示不使用指数的浮点形式,%v 表示默认格式;但 Rat.Scan 的工作是从输入流中读取一个 token 并把它写入 Rat,它没有“按浮点精度输出”的任务。

因此标题中的“相同读取规则”有一个明确边界:只讨论 fmt.Scanner 调用 Rat.Scan 时传入的 verb。后续如果用 fmt.Printf 输出这个 Rat,输出动词仍然会按照格式化规则处理。

fmt Fscanf 将格式动词传给 Rat.Scan 并由支持集合决定是否继续解析的静态结构图
图1:格式动词进入 Rat.Scan 后统一分派到同一解析入口的结构示意图,不是运行截图。

用最小示例对比 %f 和 %v

下面让两个独立的 Rat 读取同一个十进制文本。代码里的注释只标出输入、目标对象和错误处理这几个关键点:

package main

import (
	"fmt"
	"math/big"
	"strings"
)

func main() {
	var fromF, fromV big.Rat

	// %f 和 %v 都通过 Rat.Scan 读取同一个输入 token。
	_, errF := fmt.Fscanf(strings.NewReader("12.50"), "%f", &fromF)
	_, errV := fmt.Fscanf(strings.NewReader("12.50"), "%v", &fromV)
	if errF != nil || errV != nil {
		// 任一输入失败都停止继续使用结果,避免把零值当成解析成功。
		panic(fmt.Errorf("scan failed: %v, %v", errF, errV))
	}

	// RatString 输出规范化后的有理数形式,便于比较两个结果。
	fmt.Println(fromF.RatString())
	fmt.Println(fromV.RatString())
}

两行都会输出 25/2。这里的等价不是把小数保存成二进制浮点数,而是把输入文本解析成精确的有理数。12.50 和 25/2 表示同一个值,RatString 只是选择了规范化后的分数形式展示。

Rat.Scan 实际检查了什么

Go 官方源码把关键流程写得很直接:先调用 ScanState.Token 读取由数字、符号、小数点和指数字符组成的 token;然后检查传入的 verb 是否属于 efgEFGv;最后把 token 交给 SetString。因此 f 和 v 只影响“动词是否合法”,并不选择两套不同的数值算法。

// Rat.Scan 的结构关系示意:输入和动词都进入同一条解析路径。
func scanRat(state fmt.ScanState, verb rune, target *big.Rat) error {
	// 只有官方支持集合中的扫描动词才允许继续。
	if !strings.ContainsRune("efgEFGv", verb) {
		return errors.New("Rat.Scan: invalid verb")
	}

	// 实际实现会从 ScanState 取得 token,再交给 Rat 的字符串解析逻辑。
	token, err := state.Token(true, ratToken)
	if err != nil {
		return err
	}
	if _, ok := target.SetString(string(token)); !ok {
		return errors.New("Rat.Scan: invalid syntax")
	}
	return nil
}

上面的代码是为了解释调用关系的简化示意,不是建议复制的完整替代实现。真正的标准库实现还包含自己的 token 谓词、错误文本和内部解析细节;读者只需要抓住一件事:支持集合中的动词最终共享同一条转换路径。

Rat.Scan 先提取输入 token 再交给 Rat 解析并返回错误或规范化结果的静态流程图
图2:输入 token、动词检查和 Rat 解析结果之间的关系示意图,不是运行截图。

哪些动词可以用,哪些会失败

不要根据输出场景的习惯给 Rat.Scan 任意添加动词。它的支持集合很小,而且大小写对应的成员也都在同一组里:

动词Rat.Scan 是否接受含义
%e、%E接受进入 Rat 的通用扫描路径
%f、%F接受与其他受支持动词采用相同读取规则
%g、%G接受不会单独启用另一种精度模式
%v接受默认扫描动词也映射到同一路径
%d、%s不接受不在 Rat.Scan 的支持集合中

例如把格式改成 %d,错误重点就不再是输入文本是否为合法有理数,而是 Rat.Scan 先拒绝了不支持的动词。排查时先看格式字符串,再看 token 内容,定位会更快。

为什么标准库选择让它们等价

Rat 的目标是表达有理数,不是保存“这次输入使用了 %f 还是 %v”。只要输入可以表示成有理数,扫描阶段最重要的是把文本交给同一个精确解析入口;如果为每个格式动词设计一套不同规则,反而会让同一个数在不同格式下产生不必要的差异。

这也解释了为什么格式动词不会改变 Rat 的精度。精度或舍入是浮点类型需要重点处理的问题,Rat 保存的是分子和分母的精确关系。想改变展示形式,应在读取完成后使用适合输出的 API,而不是期待 %f 在输入阶段触发浮点舍入。

工程上怎么选

  • 团队约定使用“默认扫描”时,可以选 %v,它能直观表达“让 Rat 使用默认支持路径”。
  • 格式模板本身已经按浮点输入字段组织时,可以用 %f,但要在注释或文档中说明对 Rat.Scan 来说它与 %v 等价。
  • 需要校验输入格式、记录更明确的错误或绕开 fmt 时,可以先读取字符串,再显式调用 Rat.SetString,把输入边界放在业务代码中。

无论选择哪个合法动词,都不要把它当作输出格式配置。输入动词只决定 Rat.Scan 是否接收这次调用;真正的数值结果来自输入 token 的解析。

相关问题

为什么 %f 读取后不是浮点数?因为目标参数是 *big.Rat,它的 Scan 负责把 token 转成有理数;动词不会把目标对象改成 float64。

%v 会让 Rat 使用默认输出格式吗?在 Rat.Scan 中不会。它只是被接受的扫描动词之一,和 %f 走同一读取规则;输出时再由 fmt.Printf 的格式决定展示方式。

输入不合法时应该先查什么?先确认格式动词是否属于 e/E/f/F/g/G/v,再检查输入 token 是否能被 Rat 解析。这样可以区分“动词不支持”和“文本语法错误”。

把这篇文章压缩成一句话:Rat.Scan 的 %f 和 %v 都是合法入口,但它们不携带不同的数值语义,最终都使用同一套有理数读取规则。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>