Golang字符串转整数：Atoi与ParseInt区别详解

在Go语言中，字符串转整数看似简单，实则暗藏陷阱：`strconv.Atoi`虽简洁易用，却仅限十进制、固定位宽且无法区分格式错误与数值溢出，适合配置项等受控场景；而`strconv.ParseInt`才是生产环境的真正主力——它支持2–36任意进制、精确控制位宽（如int32/int64）、清晰分离各类错误（包括`strconv.ErrRange`），还能处理前缀、符号和空白，是应对用户输入、协议解析、跨平台兼容等复杂需求的健壮首选。别再把Atoi当作“安全默认”，理解二者本质差异，才能写出既正确又可维护的转换逻辑。

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。

• 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 数字字符**（如全角 "１２３"），会直接报错。

• 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 开始写起。

理论要掌握，实操不能落！以上关于《Golang字符串转整数：Atoi与ParseInt区别详解》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！