在编写程序时,我们经常会遇到各种不符合预期的情况,比如两个数相除时除数为 0、输入的年龄为负数,或者要读取的文件不存在。在 Java、Python 等其他编程语言中,一般使用 try...catch 抛出并捕获异常。
Go 语言则采用了更加直接的设计:把 “错误(error)” 当作一个普通的函数返回值交给调用者,由调用者自己检查并处理。
在 Go 语言中,error 本质上是一种内置的接口,它的默认零值为 nil。如果函数返回的 error 为 nil,说明执行成功;如果返回的不是 nil,就说明执行过程中出了问题(如下图所示)。

使用 errors.New() 创建错误
在 Go 语言中,当错误提示信息是一段固定不变的文字时,我们可以使用标准库 "errors" 包提供的 errors.New() 函数来创建一个错误。
语法:
import "errors"
err := errors.New("错误描述")说明:
errors.New() 接收一个字符串参数,用来描述出错的具体原因,并返回一个 error 类型的错误值。其中,变量名 err 是英文 “error(错误)” 的缩写,也是 Go 语言中接收错误返回值最常用的命名。
示例 1:使用 errors.New() 返回错误
package main
import (
"errors"
"fmt"
)
// 定义两数相除函数
func divide(a, b int) (int, error) {
if b == 0 {
return 0, errors.New("除数不能为 0")
}
return a / b, nil
}
func main() {
// 1. 传入除数 0
res1, err := divide(10, 0)
if err != nil {
fmt.Println(err)
} else {
fmt.Println(res1)
}
// 2. 传入正常除数 2
res2, err := divide(10, 2)
if err != nil {
fmt.Println(err)
} else {
fmt.Println(res2)
}
}运行结果如下。
除数不能为 0
5分析:
在这个例子中,divide() 的返回值列表写成了 (int, error),表示同时返回计算结果和错误信息。按照 Go 语言函数返回值的编码规范,多返回值函数如果可能产生错误,习惯把 error 放在最后一个位置上,不要反过来写成 (error, int)。
当 b == 0 出错时,为什么 return 后面还要先写一个 0 呢?因为函数声明了两个返回值,返回时必须按个数填齐。此时算不出有效的商,按惯例就填默认零值 0 占位,再返回错误。正常情况下则返回商 a / b 和 nil。
在 main() 函数中,每次调用 divide() 后我们都通过 if err != nil 判断是否出错。第 1 次传入除数 0 时,err 不为 nil,输出错误提示。第 2 次传入除数 2 时,err 为 nil,进入 else 分支输出结果 5。
小伙伴们在调用可能出错的函数时,一定要养成 “先判断 err 是否为 nil,再使用结果变量” 的习惯。
// 正确方式
res, err := divide(10, 0)
if err != nil {
fmt.Println(err)
}
// 错误方式
res, _ := divide(10, 0)
fmt.Println(res)如果像上面的错误方式那样使用空白标识符 _ 直接忽略错误,当除数为 0 时程序不会给出任何提示。它会把用来占位的零值 0 当成正常计算结果继续往下使用,很容易埋下难以排查的逻辑隐患。
使用 fmt.Errorf() 格式化错误
errors.New() 只能传入固定的文本字符串。但平时写业务代码时,我们经常需要把非法年龄、订单编号等具体变量值拼进错误提示里,方便快速定位问题。这时就可以使用 "fmt" 包提供的 fmt.Errorf() 函数。
语法:
import "fmt"
err := fmt.Errorf("格式化字符串", 参数列表...)说明:
fmt.Errorf() 支持 %d、%s、%v 等格式化占位符。它会将后面的参数依次填入字符串模板中,最终生成并返回一个 error 类型的错误值。
示例 2:动态拼接错误信息
package main
import "fmt"
// 校验年龄是否合法
func checkAge(age int) error {
if age < 0 {
return fmt.Errorf("输入的年龄 %d 不合法,不能为负数", age)
}
return nil
}
func main() {
err1 := checkAge(-5)
if err1 != nil {
fmt.Println(err1)
}
err2 := checkAge(20)
if err2 == nil {
fmt.Println("年龄 20 校验通过")
}
}运行结果如下。
输入的年龄 -5 不合法,不能为负数
年龄 20 校验通过分析:
在 checkAge() 中,fmt.Errorf() 会把 age 的值 -5 填入 %d 位置,再返回一个 error。它的占位符用法跟前面学过的 fmt.Sprintf() 完全一致,区别仅在于前者返回 error,后者返回字符串。
此外,这里的 checkAge() 只负责检查参数是否合法,不需要返回其他业务数据,因此返回值类型直接写一个单独的 error 就可以了。写代码时,固定不变的错误提示直接使用 errors.New(),需要动态拼入变量值时就使用 fmt.Errorf()。
提示: Go 官方编码规范建议:如果错误描述是英文字符串,首字母一般使用小写,并且末尾不要加句号或感叹号。因为错误信息经常会被拼接到其他日志后面一起打印。
定义预置错误变量
在项目中,如果某个固定的错误会在多处用到,或者调用方需要准确判断具体发生了哪一种错误,我们通常会把它提前定义成一个以 Err 开头的包级变量。这种预置变量在 Go 语言中也常称为 “哨兵错误”。
示例 3:定义并判断预置错误
package main
import (
"errors"
"fmt"
)
// 定义包级预置错误变量
var ErrInsufficientBalance = errors.New("账户余额不足")
// 模拟扣款操作
func withdraw(balance, amount int) (int, error) {
if amount > balance {
return balance, ErrInsufficientBalance
}
return balance - amount, nil
}
func main() {
newBalance, err := withdraw(100, 150)
if err != nil {
if err == ErrInsufficientBalance {
fmt.Println("扣款失败,请先充值")
} else {
fmt.Println(err)
}
return
}
fmt.Printf("剩余余额:%d\n", newBalance)
}运行结果如下。
扣款失败,请先充值分析:
在这个例子中,我们在包级别提前定义了 ErrInsufficientBalance 变量。扣款金额大于余额时,withdraw() 直接返回该变量。调用方就能通过 err == ErrInsufficientBalance 判断是不是余额不足,进而给出针对性提示。
为什么要提前定义包级变量,而不直接写 err == errors.New("账户余额不足") 呢?因为每次调用 errors.New() 都会创建一个全新的错误对象。哪怕文字一模一样,它们也不是同一个对象,直接使用 == 比较只会返回 false。
另外可以留意 main() 里的写法:一旦发现 err != nil,我们在处理完错误后直接写 return 提前结束函数。这种 “出错就早返回” 的写法在 Go 代码里非常常见,能让后面的正常逻辑保持平铺直叙,不用层层套在 else 括号里。
如果错误在多层函数调用中被二次包装过,后续我们还可以配合 errors.Is() 函数来比对。
使用 errors.Join() 合并多个错误
有时候我们需要同时检查多个条件,比如用户注册时既要检查用户名是否为空,又要检查密码长度是否达标。从 Go 1.20 开始,标准库 "errors" 包提供了 errors.Join() 函数,可以把发现的所有问题一次性汇总返回。
语法:
err := errors.Join(err1, err2, ...)说明:
errors.Join() 可以接收任意多个 error 参数,并将其中所有非 nil 的错误合并成一个新的 error 返回。如果传入的参数中包含 nil,它会自动忽略;如果所有参数都是 nil,则会直接返回 nil。
示例 4:合并多个校验错误
package main
import (
"errors"
"fmt"
)
func checkUser(name, email, pwd string) error {
var errName, errEmail, errPwd error
if name == "" {
errName = errors.New("用户名不能为空")
}
if email == "" {
errEmail = errors.New("邮箱不能为空")
}
if len(pwd) < 6 {
errPwd = errors.New("密码长度不能少于 6 位")
}
return errors.Join(errName, errEmail, errPwd)
}
func main() {
// 邮箱合法,用户名和密码不合法
err := checkUser("", "jack@lvyenet.com", "123")
if err != nil {
fmt.Println(err)
}
}运行结果如下。
用户名不能为空
密码长度不能少于 6 位分析:
在 checkUser() 中,传入的邮箱 "jack@lvyenet.com" 校验通过,因此 errEmail 保持默认的零值 nil。
调用 errors.Join(errName, errEmail, errPwd) 时,它会自动跳过 nil,只把 errName 和 errPwd 合并成一个新的 error 返回。打印该错误时,每条提示信息都会自动独占一行显示。
小伙伴们可以把上面传入的用户名和密码也都改成合法值试一下,看看 errors.Join() 返回的结果是不是就变成了 nil。
常见问题
1. 为什么 Go 语言不使用 try...catch,而是坚持写 if err != nil?
这其实是 Go 语言有意做的工程取舍。在使用 try...catch 的语言中,代码块中间的任何一行都可能突然抛出异常并跳转到 catch 分支,单看代码表面很难看出到底哪一步会出错。
而 Go 语言把 error 当作普通返回值显式传递,大家阅读代码时就能清楚地看到哪一个函数可能失败,并在出错的位置直接处理,程序的执行流程更加清晰可控。
2. fmt.Println() 其实也有 error 返回值,为什么平时我们都没有检查它?
在标准库中,fmt.Println() 的完整返回值确实包含写入字节数和 error。但在日常控制台输出时,向屏幕打印文字几乎不会失败,就算失败程序也没法再向屏幕打印报错了,因此直接忽略它的返回值是常规做法。
不过在涉及文件读写、网络请求、数据库查询以及字符串转数字等真正容易出错的操作时,小伙伴们都应该严格写好 if err != nil 判断,不要随意忽略错误。
