strconv.Atoi 返回 error 时需用 if err != nil 检查并处理,不可忽略;可类型断言 *strconv.NumError 获取详情,用 errors.Is(err, strconv.ErrRange) 等标准方式判断错误类型;推荐封装 SafeAtoi 函数提供默认值,或改用更灵活的 strconv.ParseInt。
直接用 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 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——错误多时日志爆炸,应提前过滤或统一兜底
strconv.Atoi 本质是 strconv.ParseInt(s, 10, 0) 的快捷封装,但它的局限很明显:
"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 同样支持——这点不是区别点很多失败其实源于输入脏:前后空格、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) 能快速确认。