本文介绍如何使用类型断言识别 `strconv.parseint`/`parseuint` 等函数返回的精确错误类型，特别是区分“值超出目标类型范围”（`strconv.errrange`）与其他错误（如语法错误），从而实现更健壮的数值解析逻辑。
在 Go 中，strconv 包的数值解析函数（如 ParseInt、ParseUint、ParseFloat）在失败时统一返回 error 接口类型，但其底层实际常为具体的 *strconv.NumError 结构体。该结构体嵌套了一个更细粒度的错误字段 Err，用于标识失败的根本原因——例如 strconv.ErrRange（值超出目标整型范围）或 strconv.ErrSyntax（格式非法）。若仅用 err != nil 判断，将无法区分“输入过大”和“含非法字符”等场景，不利于针对性处理。
要精准检测“超出范围”错误，需进行两层类型断言：
- 先断言原始 error 是否为 *strconv.NumError；
- 再判断其 Err 字段是否等于 strconv.ErrRange。
以下是一个完整、可运行的示例：
package main
import (
"fmt"
"strconv"
)
func main() {
// 测试超大整数（超过 int64 最大值 9223372036854775807）
iv, err := strconv.ParseInt("18446744073709551448", 10, 64)
if err != nil {
// 第一层断言：检查是否为 *strconv.NumError
if numErr, ok := err.(*strconv.NumError); ok {
// 第二层判断：是否因范围溢出失败
if numErr.Err == strconv.ErrRange {
fmt.Printf("❌ 范围错误：'%s' 超出 int64 表示范围/n", numErr.Num)
// 此处可降级尝试 uint64 解析，或返回自定义错误
uv, uerr := strconv.ParseUint(numErr.Num, 10, 64)
if uerr == nil {
fmt.Printf("✅ 改用 uint64 解析成功：%d/n", uv)
} else {
fmt.Printf("⚠️ uint64 解析也失败：%v/n", uerr)
}
return
}
}
// 其他错误（如语法错误）直接输出
fmt.Printf("❌ 解析失败：%v/n", err)
return
}
fmt.Printf("✅ int64 解析成功：%d/n", iv)
}
关键注意事项：
- ✅ 必须使用 *strconv.NumError（带指针）进行断言，因为 ParseInt 返回的是该类型的指针；
- ✅ numErr.Err 是一个 error 接口，与 strconv.ErrRange 比较时使用 == 是安全的（errors.New 创建的错误是可比较的）；
- ⚠️ 不要忽略 ok 布尔值——断言失败时 numErr 为 nil，直接访问会 panic；
- ? 实际工程中，可封装为工具函数（如 IsParseRangeError(err)），提升复用性与可读性。
通过这种结构化错误识别方式，你能构建更具弹性的数值处理流程，例如自动切换有符号/无符号类型、提供用户友好的错误提示，或触发备用解析策略。