Go math/big.Rat.Scan 的 %f 与 %v 为什么采用相同读取规则
如果你在 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 都是合法入口,但它们不携带不同的数值语义,最终都使用同一套有理数读取规则。
Go fmt.Formatter 为什么会覆盖默认字符串格式化
- 上一篇
- Go fmt.Formatter 为什么会覆盖默认字符串格式化
- 下一篇
- Go math/bits.Len64 为什么适合计算位图宽度
-
- Golang · Go问答 | 37分钟前 | 接口 · go · Go格式化 fmt.Formatter fmt.Stringer
- Go fmt.Formatter 为什么会覆盖默认字符串格式化
- 405浏览 收藏
-
- Golang · Go问答 | 37分钟前 | 切片 · 标准库 · Go问答 · Go encoding/binary AppendUint32 binary.LittleEndian 小端字节序
- Go binary.LittleEndian.AppendUint32 怎样向缓冲区追加整数
- 327浏览 收藏
-
- Golang · Go问答 | 46分钟前 | 标准库 · 错误处理 · 模板 · Go问答 · Go 自定义函数 text/template 模板解析 template.FuncMap
- Go template.FuncMap 怎样给模板注入自定义函数
- 286浏览 收藏
-
- Golang · Go问答 | 51分钟前 |
- Go flag.FlagSet.VisitAll 为什么看不到未显式设置的参数
- 323浏览 收藏
-
- Golang · Go问答 | 52分钟前 | go · Go JSONHandler ReplaceAttr log/slog
- Go log/slog JSONHandler 为什么会把时间写成 RFC3339
- 240浏览 收藏
-
- Golang · Go问答 | 53分钟前 |
- Go cgo.Handle 为什么不能把 Go 指针直接传给 C
- 181浏览 收藏
-
- Golang · Go问答 | 53分钟前 |
- Go unsafe.Slice 为什么要求指针和长度匹配
- 349浏览 收藏
-
- Golang · Go问答 | 55分钟前 |
- Go runtime/debug.FreeOSMemory 什么时候适合主动调用
- 222浏览 收藏
-
- Golang · Go问答 | 1小时前 |
- Go token.File.Name 怎样取回注册时的源码文件名
- 182浏览 收藏
-
- Golang · Go问答 | 1小时前 | 标准库 · Go问答 · Go 文档注释 ast go/doc go/parser.ParseComments
- Go go/parser.ParseComments 为什么影响文档注释提取
- 172浏览 收藏
-
- Golang · Go问答 | 1小时前 |
- Go go/ast.Inspect 为什么不能直接修改遍历节点
- 116浏览 收藏
-
- Golang · Go问答 | 1小时前 | go · Go context runtime/trace NewTask
- Go runtime/trace.NewTask 为什么需要在 goroutine 边界传递 Context
- 278浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1107次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1099次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1270次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1212次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1059次使用
-
- Go map 并发写 panic 怎么办:从共享 map 到可控写入路径
- 2026-06-30 123浏览
-
- go语言标准库fmt包的一键入门
- 2023-01-24 335浏览
-
- go语言中的defer关键字
- 2023-02-17 150浏览
-
- Golang中Interface接口的三个特性
- 2023-01-07 394浏览
-
- go语言中函数与方法介绍
- 2023-01-07 297浏览

