
strconv.Parseint 处理非十进制输入时,base 参数不能写错
很多人用 strconv.ParseInt 转二进制或十六进制字符串,结果 panic 或返回 0,根本原因是 base 值传错了。它不是“想转成几进制就填几”,而是“源字符串是几进制就填几”。比如 "1010" 是二进制字符串,base 得传 2;"ff" 是十六进制,base 得传 16。
常见错误现象:strconv.ParseInt("1010", 10, 64) 会把字符串当十进制解析,结果是 1010,不是 10;更糟的是传 base=0 —— 它会按前缀自动推断("0x"→16,"0b"→2),但 go 标准库不识别 "0b",只认 "0"(八进制)和 "0x"(十六进制),所以 "0b1010" 会被当成八进制,直接报错。
- 正确做法:明确指定源进制,如二进制输入用
strconv.ParseInt(s, 2, 64) - 十六进制字符串通常带
"0x"前缀,可先用strings.TrimPrefix(s, "0x")去掉再传base=16,避免base=0的歧义 - 注意返回值第二个是
Error,必须检查,ParseInt遇到非法字符(如"12g"转十进制)会返回strconv.ErrSyntax
strconv.FormatInt 生成的字符串不含前缀,要手动加
strconv.FormatInt 只负责把整数转成指定进制的纯数字字符串,不会加 "0b"、"0x" 这类前缀。很多人期望 FormatInt(10, 2) 返回 "0b1010",实际得到的是 "1010" —— 这不是 bug,是设计如此。
使用场景:做命令行工具或 API 输出时,用户常需要带前缀的格式;做内部计算则不需要。要不要加、加什么,得由你控制。
立即学习“go语言免费学习笔记(深入)”;
- 二进制补前缀:
"0b" + strconv.FormatInt(n, 2) - 十六进制统一小写且补前缀:
"0x" + strings.ToLower(strconv.FormatInt(n, 16)) - 八进制注意:Go 默认输出无前缀,但 POSIX 八进制习惯以
"0"开头,如"012"表示十进制 10,此时需手动拼接"0" + strconv.FormatInt(n, 8),但别用FormatInt(n, 8)后再补两个零——那是错的
处理超大数值时,int64 会溢出,别硬扛
进制转换器如果支持任意长度字符串(比如 256 位二进制),strconv.ParseInt 直接失败:它的目标类型是 int64,最大只到 2⁶³−1。一旦输入超过这个范围,err 是 strconv.ErrRange,不是语法错,容易被忽略。
性能与兼容性影响:用 math/big.Int 替代能解决,但代价是分配堆内存、速度慢 10–100 倍。是否值得,取决于你的使用场景——教学小工具用 int64 完全够;解析区块链地址或密码学数值,必须切到 *big.Int。
- 快速判断是否溢出:先用
ParseInt尝试,捕获strconv.ErrRange,再走big.Int.SetString(s, base) -
big.Int.SetString的base含义和ParseInt一致,也必须传源进制 - 注意
big.Int的Text(base)方法返回无前缀字符串,和FormatInt行为对齐,不用额外处理
字符串输入含空格或换行?TrimSpace 不是可选项,是必做动作
用户从 stdin、文件或表单粘贴进制字符串时,极大概率带首尾空格、rn,甚至中间有空格(如 "10 10")。而 strconv.ParseInt 对空格零容忍——遇到就报 ErrSyntax,不是跳过。
容易踩的坑:有人只对输入做 strings.TrimSpace,但没处理中间空格;还有人用 fmt.Sscanf 试图绕过,结果引入格式依赖和额外错误分支。
- 最稳妥做法:先
strings.TrimSpace,再检查是否为空字符串,再交给ParseInt - 若需容忍中间空格(如二进制分组写法
"1010 1100"),得先strings.ReplaceAll(s, " ", "")清除所有空格,再解析 - 别用正则去“智能清洗”——进制字符串只含有限字符集(0–9、a–f、A–F),过度清洗可能误删有效内容,比如把
"0x00"里的"00"当冗余删掉
进制转换看着简单,真正稳定运行的关键,往往卡在输入清洗、错误分支覆盖、以及 int64 和 big.Int 的边界切换上——这几个点漏一个,上线后就等着收告警。