strconv ParseInt 的 bitSize 如何限制溢出

我在接收命令行参数时最容易低估的一个细节，就是把 strconv.ParseInt 的第三个参数写成了“返回值类型”。它真正限制的是输入必须落入哪一种有符号整数范围。bitSize=8 只接受 -128 到 127；输入 128 会得到 ErrRange，即使函数同时返回了 127，也不能把这次解析当成成功。

bitSize 决定的不是返回类型，而是可接受范围

ParseInt 的签名始终返回 int64，但 bitSize 会在解析时先收紧目标范围。0 代表当前平台的 int，其余常用值对应固定宽度：

这里有个迁移时很实用的判断：配置文件若要跨 32 位和 64 位机器保持同样含义，不要依赖 bitSize=0，直接选 8、16、32 或 64。另一方面，base 和 bitSize 是两套边界：前者决定数字怎样解释，后者决定结果能否装下。使用 base=0 时，0x、0b 等前缀会参与判断，下划线也遵循 Go 整数字面量规则。

先判断 ErrRange，再决定是否接受输入

业务代码不要只检查“有没有拿到一个数字”。下面这个函数把字符串解析为 int8，并把语法错误、范围错误保持为不同的错误分支：

package main

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

func parseInt8(s string) (int8, error) {
    // bitSize=8 把可接受范围固定为 int8，而不是依赖机器位数。
    n, err := strconv.ParseInt(s, 10, 8)
    if err != nil {
        var numErr *strconv.NumError
        // NumError 能保留原始输入，便于日志和字段级提示。
        if errors.As(err, &numErr) {
            if errors.Is(numErr.Err, strconv.ErrRange) {
                return 0, fmt.Errorf("%q 超出 int8 范围: %w", numErr.Num, numErr.Err)
            }
            if errors.Is(numErr.Err, strconv.ErrSyntax) {
                return 0, fmt.Errorf("%q 不是合法整数: %w", numErr.Num, numErr.Err)
            }
        }
        return 0, err
    }
    // 只有 err 为 nil 时，返回值才可以进入业务逻辑。
    return int8(n), nil
}

注意示例中没有把越界时返回的 127 或 -128 当作兜底值。官方语义是：范围错误时返回适合该位宽和符号的最大绝对值，同时返回 ErrRange。这两个结果一起存在，是为了让调用方既能诊断边界，也能明确拒绝数据。

ErrSyntax 和 ErrRange 要分开处理

同一个 API 的失败原因可能完全不同。"12x" 是语法问题，"128" 在 bitSize=8 下是范围问题；前者通常提示用户修正输入，后者则更像字段定义或协议约束不匹配。

如果只想识别范围错误，可以直接使用 errors.Is(err, strconv.ErrRange)；如果还要记录原字符串，再通过 errors.As 取出 *strconv.NumError。不要用字符串比较 err.Error()，那会把稳定的错误语义绑死在展示文本上。

迁移前的四项回归检查

1. 确认字段是机器相关的 int，还是协议定义的固定宽度；跨平台协议优先使用固定 bitSize。
2. 至少覆盖 0、正边界、负边界，以及边界外一位：例如 bitSize=8 测试 127、128、-128、-129。
3. 为 base=0 单独覆盖十进制、十六进制和前缀输入，不要把进制错误误判成位宽溢出。
4. 规定错误策略：配置加载阶段通常直接拒绝并指出字段；交互式输入可以提示范围，但仍不能吞掉 ErrRange。

常见问题

bitSize=64 时还会溢出吗？

会。超过 int64 的有符号范围仍返回 ErrRange，bitSize=64 不是无限精度。

为什么 bitSize=0 不适合协议字段？

它跟随当前平台的 int 宽度，同一份配置在 32 位和 64 位环境可能拥有不同上限。

ErrRange 时返回的边界值能直接使用吗？

不能。它适合帮助日志说明“靠近哪一侧边界”，业务代码应先处理错误，再决定是否拒绝或让用户重填。