Go math/big 怎样解析带进制的大整数文本

我第一次把配置里的超长编号接到 Go 程序时，真正容易踩坑的不是“大整数”本身，而是文本的进制信息：有的输入带 0x，有的输入只是一串十六进制字符，还有的输入为了可读性夹着下划线。math/big.Int.SetString 可以处理这些情况，但 base 选错后，前缀、下划线和大小写的含义都会变化。

最稳的做法是：输入遵循 Go 风格前缀时传 base=0；格式已经由协议固定时传明确的 2 到 62 之间的进制；始终检查返回的布尔值，不要在失败后继续使用接收对象。官方地址：https://pkg.go.dev/math/big@go1.27.3#Int.SetString

SetString 要求整个字符串都能被当前进制解释，不是“读到一半就算成功”。参数 base 决定是否识别前缀和下划线，返回值中的 bool 才是这次解析是否完成的依据。

先把输入格式和 base 对齐

如果文本可能出现 0b、0o、0x 前缀，或者希望允许数字之间用下划线分组，传 0 最省心。此时前缀分别选择二进制、八进制和十六进制，没有前缀则按十进制解释。相反，协议已经明确“这是 16 进制字段”时，传 16 更直接；输入不应再带 0x，下划线也不会被当作分隔符。

把 SetString 的两个返回值当成一组处理

SetString 的签名是 SetString(s string, base int) (*Int, bool)。成功时返回解析后的整数指针和 true；失败时返回 nil, false，接收对象的值也不应再被当成可靠结果。对外部输入来说，先判断 ok，再格式化或参与计算，是比检查结果是否为零更准确的边界。

package main

import (
	"fmt"
	"math/big"
)

func parseNumber(label, text string, base int) {
	n, ok := new(big.Int).SetString(text, base) // 返回值同时表达数值和解析是否成功
	if !ok {
		fmt.Printf("%s 解析失败: %q (base=%d)\\n", label, text, base) // 失败时不读取 n
		return
	}
	fmt.Printf("%s = %s\\n", label, n.Text(10)) // 统一用十进制展示，便于后续比较
}

func main() {
	parseNumber("带前缀二进制", "0b_1011_0101", 0) // base=0 才按规则识别前缀和下划线
	parseNumber("协议十六进制", "7fffffffffffffff", 16) // 显式 base 时输入不再带 0x
	parseNumber("非法数字", "12xz", 16) // 整个字符串必须有效，不能只接受前缀
}

这里把接收对象直接写成 new(big.Int)，避免复用一个旧对象时误以为解析失败会保留旧值。若解析成功后还要计算，可以继续使用返回的 *big.Int；如果需要长期保存，仍要按你的对象生命周期决定是否复制。

大小写、进制上限和下划线是三个独立判断

进制不超过 36 时，大小写字母代表同一组数字：a 和 A 都表示 10，最多到 z/Z 表示 35。进制大于 36 时，大写字母继续提供 36 到 61 的数字值，因此最大进制是 62。这个规则适合压缩型标识，但不适合把大小写不敏感的业务编号直接当作 62 进制。

下划线只在 base=0 时按数字分组规则处理，例如 0x_f0_0d 合法；在显式 base=16 时，下划线不是分隔符。另一个容易忽略的点是，base=0 下没有前缀的文本按十进制处理，所以字符串 1e3 不是“带字母的十六进制”，而会因为 e 不是十进制数字而失败。

我的推荐流程与速查表

1. 先问清输入协议是否允许前缀和分隔符；不清楚时不要直接猜 base。
2. Go 风格数字用 base=0，固定字段用明确进制，并在接口层记录这个约定。
3. 先判断 ok，失败就返回带原始输入上下文的错误，成功后再做比较、运算和输出。
4. 需要稳定日志时用 Text(10) 输出十进制；需要恢复原进制时传入对应的 2…62。

相关问题

SetString 能不能只解析字符串前缀？不能。只要尾部还有不能按当前进制解释的字符，整体就不算成功。

base=0 时可以传大写前缀吗？可以，0B、0O、0X 都属于文档支持的前缀形式。

解析后的大整数怎样转回文本？使用 Text(base)，其中 base 为 2 到 62；日志和接口输出通常选 10，避免把展示进制和输入协议混在一起。