在 Go 语言中,字符串和整数不能直接做算术运算。平时读取表单参数、配置文件或命令行内容时,拿到的通常是 "100"、"-25" 这样的数字字符串。如果我们想拿它们去做加减计算或比较大小,就必须先把 string 转换为 int 整数。
需要注意的是,我们不能直接写 int("100") 来转换字符串,而是要使用标准库 strconv 包提供的 strconv.Atoi() 函数来实现。
strconv.Atoi() 语法
标准库中的 strconv 是 “string conversion(字符串转换)” 的缩写,专门用来处理字符串与基本数据类型之间的互转。其中,Atoi 是 “ASCII to integer(把字符串转换为整数)” 的缩写,也是我们将字符串转为 int 最常用的函数。
语法:
num, err := strconv.Atoi(s)说明:
strconv.Atoi() 接收一个待转换的字符串 s,并同时返回 num 和 err 两个值。其中,num 是转换后的 int 整数,err 用来记录转换过程中是否出错。
如果传入的是合法的十进制整数字符串(如 "120" 或 "-45"),转换成功时 err 的值为 nil。
一旦字符串里混入了非数字字符(如 "120abc"、小数 "3.14" 或空字符串 ""),或者数值超出了 int 的取值范围,转换就会失败并返回非空的 err。
此时返回的 num 可能是 0(格式错误),也可能是整型的最大或最小边界值(数值溢出)。这个结果完全不可信,因此我们必须先检查 err。
注意: 基础转换语法 int(x) 只能把浮点数或其他整数类型转为 int,不能直接转换字符串。如果我们写成 int("100"),编译器会直接报错,提示无法将字符串转换为 int 类型。
strconv.Atoi() 示例
接下来,我们通过几个简单的例子来看看 strconv.Atoi() 是如何使用的。
示例 1:转换普通数字字符串
package main
import (
"fmt"
"strconv"
)
func main() {
s := "120"
num, err := strconv.Atoi(s)
if err != nil {
fmt.Println("转换失败:", err)
return
}
fmt.Println(num + 30)
fmt.Printf("%T\n", num)
}运行结果如下。
150
int分析:
上面这个例子非常简单,其实就是调用 strconv.Atoi(s) 把字符串 "120" 转换成了 int 类型的整数 120。
按照 Go 语言中错误处理的常规写法,我们先通过 if err != nil 判断转换是否出错。确认没有报错后,就能放心地拿 num 与 30 相加,得到结果 150。
如果传入的字符串里混入了字母、小数点,或者超出了 int 的取值范围,又会发生什么呢?下面我们再来看一个例子。
示例 2:转换非法字符串
package main
import (
"fmt"
"strconv"
)
func main() {
s := "120abc"
num, err := strconv.Atoi(s)
if err != nil {
fmt.Println("转换失败:", err)
return
}
fmt.Println(num)
}运行结果如下。
转换失败: strconv.Atoi: parsing "120abc": invalid syntax分析:
在这个例子中,字符串 "120abc" 末尾混入了英文字母,无法解析成合法整数。此时 err 不为 nil,程序进入 if 分支打印出 invalid syntax(语法无效)的错误提示并提前退出。
如果传入的纯数字字符串超出了 int 的取值范围,错误信息则会提示 value out of range(数值超出范围)。
这里小伙伴们要留意,哪怕传入带小数点的字符串(如 "3.14"),strconv.Atoi() 也不会自动截断小数,而是直接报错。如果确实要把小数文本转成整数,可以先调用 strconv.ParseFloat() 解析成浮点数,再通过 int() 截断小数。
此外,解析外部输入时千万不要使用 _ 忽略 err。否则一旦转换失败,错误结果 0 混入后续计算中,程序不会立刻崩溃,反而会悄悄算出错误数据。
在实际读取用户输入或文件内容时,数字字符串的首尾经常会不小心带上空格或换行符 \n,直接传入同样会转换失败。遇到这种情况应该怎么处理呢?请看下面例子。
示例 3:去除首尾空白后再转换
package main
import (
"fmt"
"strconv"
"strings"
)
func main() {
input := " 2026\n"
cleanStr := strings.TrimSpace(input) // 去除首尾空格和换行符
num, err := strconv.Atoi(cleanStr)
if err != nil {
fmt.Println("转换失败:", err)
return
}
fmt.Println(num)
}运行结果如下。
2026分析:
strconv.Atoi() 对格式要求非常严格,哪怕字符串开头或结尾多了一个空格或换行符 \n,直接转换都会返回 invalid syntax 错误。
因此,处理来自终端输入、文件或网络接口的文本时,我们习惯先调用 strings.TrimSpace() 去掉首尾的空白字符,然后再执行转换。平时写代码时,我们也可以直接把两步合写成一行 strconv.Atoi(strings.TrimSpace(input))。
常见问题
1. 如果数字字符串前面带有正号 "+100" 或前导零 "007",strconv.Atoi() 能正常转换吗?
完全可以。strconv.Atoi() 支持开头带有正号 "+" 或负号 "-" 的十进制数字字符串,也会自动忽略数字前面的前导零。比如 strconv.Atoi("+100") 会得到整数 100,strconv.Atoi("007") 会得到整数 7。
不过小伙伴们要注意,strconv.Atoi() 只支持十进制格式,不支持 "0x10" 这类带进制前缀的字符串,返回结果也固定是 int 类型。如果遇到带进制前缀的字符串,或者需要直接解析为 int64 类型,我们可以改用 strconv.ParseInt() 来处理。
