strconv.Atoi仅支持十进制int转换,适用配置项等简单场景;strconv.ParseInt提供进制、位宽等完整控制,是健壮转换的首选。

strconv.Atoi 适合简单场景,但只支持十进制 int
strconv.Atoi 是最简捷的字符串转整数方式,但它内部固定调用 strconv.ParseInt(s, 10, 0),意味着:只能解析十进制、结果类型是 int(平台相关,32 或 64 位)、不接受前缀(如 "0x" 或 "0b")。
常见错误现象:strconv.Atoi("0xFF") 报 invalid syntax;strconv.Atoi("12345678901234567890") 在 32 位系统可能溢出,返回 0 并带错误。
- 适用场景:配置项、命令行参数等明确为十进制正整数且范围可控的场合
- 不用手动指定进制或位宽,写起来快,但灵活性为零
- 性能略优于
ParseInt(少一次函数跳转和参数检查),但差异微乎其微
strconv.ParseInt 才是真正可控的转换入口
strconv.ParseInt 提供完整控制:进制(base)、目标位宽(bitSize)、错误处理。它返回 int64 和 error,由你决定是否截断或校验。
典型误用:strconv.ParseInt("123", 10, 32) 返回 int64(123),需显式转成 int32;若字符串超出范围(如 "2147483648" 转 int32),会返回 strconv.ErrRange,不是 panic。
立即学习“go语言免费学习笔记(深入)”;
-
base可取 2–36,支持"1010"(base=2)、"FF"(base=16)、甚至"z"(base=36) -
bitSize控制结果类型大小:传32得int32值(需自己转),传64得int64—— 它不自动适配平台int - 空格、
+/-前缀被接受,但"0x"等前缀必须靠strconv.ParseInt(strings.TrimPrefix(s, "0x"), 16, 64)手动处理
num, err := strconv.ParseInt("1A", 16, 64)
if err != nil {
log.Fatal(err)
}
fmt.Printf("%d\n", num) // 输出 26
什么时候该用 ParseInt 而不是 Atoi
只要出现以下任一情况,就别用 Atoi:
- 输入可能带
"0x"、"0b"、"0o"前缀(得先清理再选base) - 需要明确限定为
int32或int16(比如协议字段、数据库映射) - 要区分「格式错误」和「数值越界」——
Atoi对二者都返回同一个error类型,而ParseInt的ErrRange可以精确判断 - 输入来自不可信源(如用户表单、API 请求),必须做边界校验,不能依赖默认
int行为
容易被忽略的细节:符号、空格与 Unicode
ParseInt 和 Atoi 都会跳过开头的空白(' '、'\t'、'\n' 等),但遇到非数字/合法符号即停。它们**不支持 Unicode 数字字符**(如全角 "123"),会直接报错。
-
strconv.Atoi(" -42 ")成功返回-42;但strconv.Atoi("−42")(Unicode 减号 U+2212)失败 - 十六进制字母不区分大小写:
ParseInt("aF", 16, 64)和ParseInt("AF", 16, 64)都行 - 进制为 0 时,会按前缀自动识别:`ParseInt("0x1F", 0, 64)` →
31,`ParseInt("0755", 0, 64)` →493(八进制),但Atoi不支持base=0
实际项目里,多数人卡在没意识到 Atoi 是个“简化封装”,而不是“更安全的默认选择”。真正健壮的转换逻辑,几乎总是从 ParseInt 开始写起。









