strconv.Atoi 返回 error 时需用 if err != nil 检查并处理,不可忽略;可类型断言 *strconv.NumError 获取详情,用 errors.Is(err, strconv.ErrRange) 等标准方式判断错误类型;推荐封装 SafeAtoi 函数提供默认值,或改用更灵活的 strconv.ParseInt。

strconv.Atoi 返回 error 怎么判断和处理
直接用 strconv.Atoi 转字符串为整数时,只要输入不是合法十进制整数(比如空字符串、带空格、含字母、超范围),它就返回非 nil 的 error。别忽略这个 error,否则程序可能 panic 或逻辑错乱。
正确做法是始终检查返回的 error,而不是只取 int 值:
num, err := strconv.Atoi("123abc")
if err != nil {
log.Printf("转换失败:%v", err) // 输出:strconv.Atoi: parsing "123abc": invalid syntax
return
}
fmt.Println(num) // 不会执行到这里
-
err类型是*strconv.NumError,可类型断言获取更细信息(如err.(*strconv.NumError).Func是"Atoi",.Num是原始字符串) - 常见错误值包括:
strconv.ErrSyntax(格式不对)、strconv.ErrRange(超出int范围) - 不要用
fmt.Sprintf("%v", err)判断内容——错误文本可能随 Go 版本变化,应依赖errors.Is(err, strconv.ErrRange)等标准判断
想忽略错误直接给默认值?别硬写 if-else
频繁写 if err != nil { return 0 } 不仅啰嗦,还容易漏处理。封装一个安全转换函数更可靠:
func SafeAtoi(s string, fallback int) int {
if n, err := strconv.Atoi(s); err == nil {
return n
}
return fallback
}
// 使用
age := SafeAtoi(userInput, 0) // 转失败就用 0
- 注意:
fallback选值要符合业务语义,比如用-1表示“无效年龄”比用0更明确 - 避免在循环里反复调用未校验的
strconv.Atoi——错误多时日志爆炸,应提前过滤或统一兜底 - 如果 fallback 需要复杂逻辑(如从配置读、调 API),建议把 fallback 抽成函数参数,而非写死
为什么不用 Atoi?考虑 strconv.ParseInt 替代方案
strconv.Atoi 本质是 strconv.ParseInt(s, 10, 0) 的快捷封装,但它的局限很明显:
立即学习“go语言免费学习笔记(深入)”;
- 只能转 base=10,不能处理十六进制(
"0xFF")、二进制等 - 目标类型固定为
int(32 或 64 位取决于平台),无法指定int64精确控制 - 溢出时统一报
ErrRange,但不告诉你原数是正溢出还是负溢出
需要更高精度或更多控制时,直接用 strconv.ParseInt:
n, err := strconv.ParseInt("9223372036854775808", 10, 64) // 超 int64 最大值
if errors.Is(err, strconv.ErrRange) {
// 明确知道是范围问题,可做特殊处理(如截断、告警)
}
-
ParseInt(s, base, bitSize)的bitSize必须是 0、8、16、32、64;0表示用int默认宽度 - 若需兼容负号开头的字符串,
ParseInt支持,但Atoi同样支持——这点不是区别点 - 性能上两者几乎无差别,选哪个取决于你需要的灵活性
字符串预处理能避免很多 Atoi 失败
很多失败其实源于输入脏:前后空格、BOM 字符、不可见控制符。别指望 Atoi 自动 trim。
- 用
strings.TrimSpace清除首尾空白(" 42 "→"42") - 用
strings.Trim清除特定字符(如 JSON 中可能带引号:"/"123/""→strings.Trim(s, `"`))
- 用
unicode.IsDigit或正则粗筛(慎用:正则有开销,仅当批量校验且格式极不规范时考虑)
例如处理用户表单输入:
s := strings.TrimSpace(userInput)
if s == "" {
return 0, errors.New("输入为空")
}
// 再尝试转换
num, err := strconv.Atoi(s)
空字符串、纯空格、全是符号的输入,在 Atoi 前拦截,比让 Atoi 报 ErrSyntax 更利于定位问题。
最常被忽略的是 Unicode 空格(如 )和 BOM 头——用 utf8.RuneCountInString 或调试打印 []byte(s) 能快速确认。
