Go math/big.Int.SetString 读取不同进制时怎么指定 base

调用 math/big.Int.SetString 时，进制就在第二个参数 base 里指定：协议格式明确，就传具体进制；输入遵循 Go 风格前缀，就传 0 让它识别 0b、0o 或 0x。无论哪种方式，都必须检查返回的 ok，因为失败时结果指针为 nil，不能把它当成一个可用的大整数。

显式 base：固定协议就固定解释方式

如果字段约定“这是十六进制”或“这是三十六进制”，直接把约定写进调用点，阅读和审计都更简单。SetString 接受 0 或 2 到 big.MaxBase 的进制；在常见的 2 到 36 进制中，大小写字母表示相同数值，超过 36 后，大写字母还可以表示 36 到 61。

例如一个固定为十六进制的字段，可以这样封装。这里先校验长度和 base，再处理解析失败；这样来自请求参数的异常值不会直接进入后续计算。

package main

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

func parseHex(text string) (*big.Int, error) {
	// 固定协议使用 base=16，不让输入内容改变解释方式。
	if text == "" || len(text) > 256 {
		return nil, errors.New("十六进制字符串为空或过长")
	}

	// ok=false 时结果不可继续使用，统一转成业务错误。
	value, ok := new(big.Int).SetString(text, 16)
	if !ok {
		return nil, fmt.Errorf("无效的十六进制整数")
	}
	return value, nil
}

这里的长度限制是业务层策略，不是 SetString 的内置上限。大整数虽然不受 int64 位数限制，但不代表接口应该接受无限长输入；限制长度可以控制内存和 CPU 消耗。

base=0：让前缀决定进制，但别放松完整性检查

传 0 时，0b/0B 表示二进制，0o/0O 表示八进制，0x/0X 表示十六进制；没有这些前缀时按十进制解释。它适合输入格式本来就允许“自带进制”的场景，例如配置文件或调试参数。

下划线也有一个容易忽略的边界：只有 base=0 时，下划线才能作为前缀后或数字之间的分隔符；显式传 16 时，ff_20 不会被当成合法十六进制数字。无论是否有前缀，成功都要求整个字符串有效，不能只因为前半段看起来能解析就放行。

func parseAutoBase(text string) (*big.Int, error) {
	// base=0 只用于明确允许 Go 风格前缀的输入。
	if text == "" || len(text) > 256 {
		return nil, errors.New("整数文本为空或过长")
	}

	// 例如 0x_ff20 合法；结果仍要由 ok 明确确认。
	value, ok := new(big.Int).SetString(text, 0)
	if !ok {
		return nil, fmt.Errorf("整数文本包含不支持的进制或字符")
	}
	return value, nil
}

把失败当成输入拒绝，而不是把零值当成功

SetString 返回的是 (*big.Int, bool)。第二个返回值为 false 时，官方文档明确说明结果值未定义并返回 nil。因此不要只写一行调用后直接访问结果，也不要把失败统一替换成 0：这会把错误的订单号、偏移量或掩码悄悄变成另一个业务含义。

还要提前校验动态传入的 base。非法 base 会触发运行时 panic，不能把它当成普通的 ok=false 处理。若 base 来自配置或请求，应先把它限制为 0 或 2..big.MaxBase，并配合明确的空白策略：不要未经决定就自动 TrimSpace，否则日志里的“带空格输入”和真正合法的数字会失去区别。

func parseInteger(text string, base int) (*big.Int, error) {
	// 先挡住会触发 SetString panic 的非法进制。
	if base != 0 && (base  big.MaxBase) {
		return nil, fmt.Errorf("不支持的进制: %d", base)
	}
	if text == "" || len(text) > 256 {
		return nil, errors.New("整数文本为空或过长")
	}

	// 只有 ok=true 才把解析值交给业务层。
	value, ok := new(big.Int).SetString(text, base)
	if !ok {
		return nil, errors.New("整数文本格式错误")
	}
	return value, nil
}

常见问题

显式传 16 时可以写 0x 前缀吗？

不应把它当作通用写法。显式 base 表示字符串按指定进制读取，前缀识别是 base=0 的规则；如果协议固定为十六进制，建议统一传不带前缀的数字，或统一规定先去除前缀再传 16。

为什么 SetString("1_000", 10) 失败？

因为下划线分隔符只在 base=0 时被识别。若输入确实使用 Go 风格数字字面量，改用 SetString("1_000", 0)；若协议是普通十进制，应在协议层禁止下划线，而不是依赖隐式清洗。

解析成功后怎样输出指定进制？

使用 value.Text(base)，并让输出 base 与输入协议保持一致。String() 默认输出十进制，不能用它判断原始输入到底采用了什么进制。

复查清单：先确定格式，再放行结果

• 固定协议是否传了明确的 base，而不是无条件使用 0？
• 动态 base 是否先限制在 0 或 2..big.MaxBase？
• 是否限制输入长度，并明确是否允许首尾空白？
• 是否始终检查 ok，只把成功的 *big.Int 交给后续计算？