Go strconv.ParseInt 怎样按指定进制解析整数

需要把配置项、命令参数或协议字段中的文本转成整数时，strconv.ParseInt 的关键不是只把字符串传进去，而是同时把 base 和 bitSize 说清楚：前者决定按什么进制读，后者决定结果必须落在哪个有符号整数宽度内。函数返回 int64 与 error，不要忽略错误再直接转换。

官方地址：https://pkg.go.dev/strconv

固定格式的输入优先传明确的 base；只有确实要兼容 Go 整数字面量前缀时才使用 base=0。随后用 bitSize 固定范围，并把 ErrSyntax 与 ErrRange 分开处理。

先按任务选择 base

strconv.ParseInt(s, base, bitSize) 接受的 base 是 0 或 2 到 36。例如输入始终是十六进制协议字段，就传 16；如果输入可能带 0b、0o 或 0x 前缀，希望按照 Go 整数字面量规则判断，才传 0。

这两个选择不能混为一谈：固定 base 时，字符串中的数字必须符合指定进制；base=0 时，符号之后的前缀参与判断，未带这些前缀的普通数字按十进制解释。base=0 还允许符合 Go 整数字面量规则的下划线。

package main

import (
    "fmt"
    "strconv"
)

func main() {
    // 固定16进制：输入格式由协议约定，不依赖字符串前缀。
    fixed, fixedErr := strconv.ParseInt("7f", 16, 32)
    fmt.Printf("固定进制: value=%d err=%v\n", fixed, fixedErr)

    // base为0：让0x前缀参与进制识别，bitSize限制结果范围。
    auto, autoErr := strconv.ParseInt("-0x2a", 0, 16)
    fmt.Printf("自动识别: value=%d err=%v\n", auto, autoErr)
}

如果输入来自用户或外部文件，建议在进入解析函数前明确是否允许前缀和空白。ParseInt 不会把任意首尾空格当成可忽略内容；格式约束应该由输入层负责，而不是靠“解析成功后再猜测”。

用 bitSize 约束结果并区分错误

bitSize 可使用 0、8、16、32 或 64。返回值的静态类型仍然是 int64，但指定较小位宽时，解析值必须能被目标有符号类型表示。比如配置字段最终要存进 int32，就直接传 32，避免先按 64 位接受再发生不透明的收窄。

错误对象的具体类型是 *strconv.NumError。字符串为空或包含当前进制不允许的数字时，底层错误是 strconv.ErrSyntax；值超出目标位宽时，底层错误是 strconv.ErrRange。这两类错误对调用方的处理动作通常不同：前者提示输入格式，后者提示范围或配置不匹配。

package main

import (
    "errors"
    "fmt"
    "strconv"
)

func parsePortText(text string) (int32, error) {
    // bitSize=32让范围检查发生在解析阶段，而不是转换之后。
    value, err := strconv.ParseInt(text, 10, 32)
    if err != nil {
        var numErr *strconv.NumError
        // 先保留NumError上下文，再按底层原因给调用方返回可读错误。
        if errors.As(err, &numErr) {
            switch {
            case errors.Is(numErr.Err, strconv.ErrSyntax):
                return 0, fmt.Errorf("端口不是合法十进制整数: %q", text)
            case errors.Is(numErr.Err, strconv.ErrRange):
                return 0, fmt.Errorf("端口超出int32范围: %q", text)
            }
        }
        return 0, fmt.Errorf("解析端口失败: %w", err)
    }
    // 这里的转换不会丢失已通过32位范围检查的值。
    return int32(value), nil
}

示例中的 errors.As 用于拿到 NumError，errors.Is 用于判断底层错误原因。业务层不需要依赖错误字符串的具体文本，这样更适合长期维护。

在输入边界统一解析策略

同一个项目里，最容易出现的差异是：一部分字段按固定进制定义，另一部分字段允许前缀；如果把所有输入都改成 base=0，类似 08 这样的值就可能不再按“普通十进制文本”理解。解析策略应跟字段协议绑定，而不是跟调用者习惯绑定。

可以用下面的决策表收口：

无论采用哪种策略，都应在错误路径中保留字段名、脱敏后的输入摘要和目标位宽；不要把完整的敏感配置值写进日志。解析成功只代表文本符合参数契约，不能替业务判断端口、状态码或资源编号是否仍在允许集合内。

常见问题

为什么不直接用 strconv.Atoi？

Atoi 适合默认十进制和 Go int 的场景；标题中的指定进制、明确位宽和前缀识别都需要 ParseInt 的三个参数。

base=0 能解析所有带前导零的数字吗？

不能把前导零当成普通装饰。base=0 会按 Go 整数字面量规则解释前缀，固定十进制字段应显式传 10，避免输入协议和语言字面量规则混在一起。

ErrRange 时返回值还能使用吗？

不应把带错误的返回值当作业务有效结果。即使库文档描述了范围错误时的返回值，也应先处理 error，再决定是否向上层返回默认值或拒绝请求。