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,输出动词仍然会按照格式化规则处理。

用最小示例对比 %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 任意添加动词。它的支持集合很小,而且大小写对应的成员也都在同一组里:
| 动词 | 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 都是合法入口,但它们不携带不同的数值语义,最终都使用同一套有理数读取规则。
-
405 收藏
-
327 收藏
-
286 收藏
-
323 收藏
-
240 收藏
-
181 收藏
-
349 收藏
-
222 收藏
-
182 收藏
-
172 收藏
-
116 收藏
-
278 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习