go 的 `strconv` 包在解析整数失败时返回 `*strconv.numerror`，其 `err` 字段可精确区分越界（`strconv.errrange`）与语法错误（`strconv.errsyntax`），需用类型断言提取并判断。
在 Go 中处理字符串到整数的转换时，strconv.ParseInt 和 strconv.ParseUint 等函数虽能高效完成解析，但其错误类型并非单一接口，而是封装了具体原因的结构体——*strconv.NumError。该结构体包含 Func（出错函数名）、Num（原始输入字符串）和关键字段 Err（底层错误值），而 Err 正是判断错误本质的核心：若为 strconv.ErrRange，则明确表示数值超出了目标类型的表示范围（如 int64 的最大值为 9223372036854775807，而 "18446744073709551448" 显然远超此限）。
要可靠识别越界错误，必须进行两层检查：
- 类型断言：确认 err 是否为 *strconv.NumError 类型；
- 值比较：检查其 Err 字段是否等于 strconv.ErrRange。
以下是一个完整、健壮的示例：
package main
import (
"fmt"
"strconv"
)
func main() {
s := "18446744073709551448"
// 尝试解析为 int64
iv, err := strconv.ParseInt(s, 10, 64)
if err != nil {
if numErr, ok := err.(*strconv.NumError); ok {
switch numErr.Err {
case strconv.ErrRange:
fmt.Printf("❌ 越界错误：'%s' 超出 int64 表示范围\n", s)
// 此时可降级尝试 uint64 解析（如题中后续逻辑）
if uv, err2 := strconv.ParseUint(s, 10, 64); err2 == nil {
fmt.Printf("✅ 成功解析为 uint64: %d\n", uv)
} else {
fmt.Printf("⚠️ 同样超出 uint64 范围：%v\n", err2)
}
return
case strconv.ErrSyntax:
fmt.Printf("❌ 语法错误：'%s' 不是合法整数格式\n", s)
return
default:
fmt.Printf("❌ 未知转换错误：%v\n", err)
return
}
}
// 非 NumError 类型的其他错误（极少见，但需兜底）
fmt.Printf("❌ 非数字转换错误：%v\n", err)
return
}
fmt.Printf("✅ 成功解析为 int64: %d\n", iv)
}注意事项：
- ✅ 必须使用 *strconv.NumError（带星号）进行断言，因为 strconv 返回的是指针类型；
- ✅ strconv.ErrRange 是一个导出的全局变量，可直接比较，无需反射或字符串匹配；
- ⚠️ 不要依赖 err.Error() 的字符串内容做判断（如 strings.Contains(err.Error(), "out of range")），因其可能随 Go 版本变更，违反错误不可靠解析原则；
- ? 若需统一处理多种解析函数（ParseInt/ParseUint/ParseFloat），该模式完全通用，只需复用相同的 NumError 断言逻辑。
通过这种结构化错误处理，你不仅能精准响应越界场景，还能为用户提供清晰反馈，并安全地触发备用解析路径（如从 int64 切换到 uint64），显著提升程序鲁棒性与可维护性。
