Go strconv.ParseInt 怎样按前缀解析十六进制字符串

如果一份配置既可能写成 0x2A，也可能写成 42，Go 中最省事的做法是调用 strconv.ParseInt(text, 0, 64)。当 base 为 0 时，函数会根据符号后的前缀识别二进制、八进制、十六进制或十进制；只有确定输入永远是纯十六进制数字时，才更适合显式传入 16。

官方依据：https://pkg.go.dev/strconv#ParseInt

先分清 base=0 和 base=16 的职责

ParseInt 的签名是 ParseInt(s, base, bitSize)。base 决定字符按哪种进制解释，允许使用 0 或 2 到 36；bitSize 决定结果必须落在多大的有符号整数范围内。函数本身返回 int64，但传入 8、16 或 32 时，解析结果会先受对应位宽约束。

官方文档规定，base=0 时，符号之后的 0b、0o、0x 分别表示二、八、十六进制，单个前导 0 仍可表示八进制，其他无前缀输入按十进制处理；下划线也只在 base=0 时按 Go 整数字面量规则允许。

让 0x 和普通十进制共用一个解析入口

配置值来自文本时，可以把原始字符串直接交给 base=0，保留符号和前缀，不要先手工切掉 0x。这样同一个函数既能处理 0x2A、0X2A，也能处理 42 和带符号的 -0x2A。

package main

import (
    "fmt"
    "strconv"
)

func main() {
    // 同一入口接受十六进制前缀和普通十进制文本。
    inputs := []string{"0x2A", "0X2A", "42", "-0x2A", "0b101010"}

    for _, text := range inputs {
        // base=0 让 ParseInt 按符号后的前缀选择进制；64 表示目标范围。
        value, err := strconv.ParseInt(text, 0, 64)
        if err != nil {
            // 文本来自外部输入时必须保留原值，便于定位哪一项不符合协议。
            fmt.Printf("input=%q error=%v\n", text, err)
            continue
        }
        fmt.Printf("input=%q value=%d hex=%#x\n", text, value, value)
    }
}

这里的关键不是“十六进制专用函数”，而是把进制选择交给输入格式。若业务协议允许多种 Go 风格整数写法，base=0 可以减少分支；若协议只允许一个格式，固定 base 更容易把错误输入挡在边界处。

固定十六进制时，别把输入契约写模糊

有些协议把字段定义为“十六进制字符串”，但样例可能同时出现 2A 和 0x2A。这时先决定是否允许前缀，再选择调用方式：只允许裸数字就传 16 并拒绝前缀；允许标准前缀则可先统一输入规则，或者继续使用 base=0，但必须接受它同时识别二进制和八进制前缀。

package main

import (
    "fmt"
    "strconv"
)

func parseHex(text string) (int64, error) {
    // 这个入口只接受不带 0x 的十六进制数字，协议边界更明确。
    return strconv.ParseInt(text, 16, 64)
}

func main() {
    // 业务层可以在调用前决定是否剥离允许的 0x 前缀。
    value, err := parseHex("2A")
    if err != nil {
        fmt.Println("parse hex failed:", err)
        return
    }
    fmt.Printf("value=%d\n", value)
}

如果决定允许前缀，可以把“去掉前缀”做成明确的输入规范，而不是在多个调用点随手切片。手工切片时要处理大小写、空字符串和只有前缀没有数字的情况；否则错误会从“格式不符合协议”变成难以定位的空输入。

用 NumError 区分格式错和数值超范围

ParseInt 返回的错误通常是 *strconv.NumError。输入为空、含无效数字或前缀后没有有效数字时，底层原因是 strconv.ErrSyntax；数值超出 bitSize 能表示的范围时，底层原因是 strconv.ErrRange。不要只把错误打印成一行字符串后就丢弃，配置解析器至少要把这两个分支区分开。

package main

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

func parseAutoInt(text string) (int64, error) {
    // 允许前缀推断，但把解析错误原样返回给上层决定提示方式。
    value, err := strconv.ParseInt(text, 0, 32)
    if err == nil {
        return value, nil
    }

    var numErr *strconv.NumError
    if errors.As(err, &numErr) {
        // ErrSyntax 表示输入形式不合法，ErrRange 表示数值超过 32 位范围。
        switch {
        case errors.Is(numErr.Err, strconv.ErrSyntax):
            return 0, fmt.Errorf("整数格式错误 %q: %w", text, err)
        case errors.Is(numErr.Err, strconv.ErrRange):
            return 0, fmt.Errorf("整数超出 32 位范围 %q: %w", text, err)
        }
    }
    return 0, err
}

选择 bitSize=32 的示例意味着调用方要把结果放入 int32 或等价协议字段；如果只传 64，大于 32 位的值就不会在这里被拦截。错误处理的位宽应与最终存储类型保持一致。

落地时记住这四个边界

• 需要自动识别前缀：传 base=0，不要先删除 0x。
• 协议固定为十六进制：传 base=16，并明确是否允许带前缀的文本。
• 结果要放入窄类型：让 bitSize 与目标类型一致，避免解析成功后再转换溢出。
• 需要给用户可操作提示：用 errors.As 取出 NumError，再用 errors.Is 区分语法错误和范围错误。

相关问题

为什么 ParseInt("0x2A", 10, 64) 不能按十六进制解析？

因为 base=10 已经明确要求十进制，0x 不是十进制数字。需要前缀推断时改用 base=0，需要固定十六进制时先按协议处理前缀再传 16。

下划线能不能出现在十六进制字符串里？

只有 base=0 时，下划线才按 Go 整数字面量规则处理。若显式传 16，不要默认把 1_000 当作合法输入，是否允许应由业务层先做清晰的格式约定。

bitSize=0 什么时候使用？

它对应 int 的目标范围，适合结果确实要落入平台相关 int 的场景。跨平台配置或协议字段更建议显式选择 32 或 64，让范围契约稳定。