Go语言的错误处理设计遵循显式处理的原则，所有可能出现错误的函数都会将error作为最后一个返回值，调用方需要主动判断这个返回值是否为nil来确定操作是否成功。这种设计让错误处理的逻辑更加清晰，不会出现隐藏的异常流程。
基础错误处理：error接口的使用
Go语言内置的error是一个接口类型，定义非常简单，只要实现了Error() string方法的类型都可以作为错误类型。标准库中提供了errors包和fmt包来快速创建错误实例。
下面的示例展示了最基础的错误返回与判断逻辑：
package main
import (
"errors"
"fmt"
)
// 模拟一个可能出错的函数
func divide(a, b int) (int, error) {
if b == 0 {
// 使用errors包创建简单错误
return 0, errors.New("除数不能为0")
}
return a / b, nil
}
func main() {
result, err := divide(10, 0)
if err != nil {
// 处理错误
fmt.Println("计算失败:", err.Error())
return
}
fmt.Println("计算结果:", result)
}
如果需要在错误中携带更多上下文信息，可以使用fmt包的Errorf方法，它会格式化字符串并返回错误实例：
package main
import (
"fmt"
)
func readFile(path string) error {
// 模拟文件读取失败的场景
return fmt.Errorf("读取文件 %s 失败: 文件不存在", path)
}
func main() {
err := readFile("/data/test.txt")
if err != nil {
fmt.Println(err.Error())
}
}
自定义错误类型
当标准错误无法满足需求时，我们可以自定义错误类型，添加更多业务相关的字段，方便后续的错误分类和处理。
package main
import (
"fmt"
)
// 自定义错误类型，包含错误码和错误信息
type MyError struct {
Code int
Message string
}
// 实现error接口的Error方法
func (e *MyError) Error() string {
return fmt.Sprintf("错误码: %d, 错误信息: %s", e.Code, e.Message)
}
func process() error {
// 返回自定义错误实例
return &MyError{
Code: 500,
Message: "内部服务异常",
}
}
func main() {
err := process()
if err != nil {
// 类型断言获取自定义错误内容
if myErr, ok := err.(*MyError); ok {
fmt.Printf("捕获到自定义错误，错误码: %dn", myErr.Code)
} else {
fmt.Println("其他错误:", err.Error())
}
}
}
defer、panic与recover的组合使用
除了常规的错误返回值处理，Go还提供了panic和recover机制来处理严重的异常情况。panic会终止当前函数的执行，并向上层抛出，直到被recover捕获或者程序崩溃。defer语句会在函数返回前执行，通常用来配合recover捕获panic。
下面的示例展示了如何使用defer和recover捕获panic，避免程序直接崩溃：
package main
import (
"fmt"
)
func safeFunc() {
// defer语句定义匿名函数，用于捕获panic
defer func() {
if r := recover(); r != nil {
fmt.Printf("捕获到panic: %vn", r)
}
}()
// 主动触发panic
panic("发生严重错误")
fmt.Println("这行代码不会执行")
}
func main() {
fmt.Println("程序开始执行")
safeFunc()
fmt.Println("程序正常结束")
}
需要注意，panic和recover不应该用来替代常规的错误返回值处理，仅适合处理那些不可恢复的严重错误，比如数组越界、空指针引用等运行时错误，或者程序启动阶段的致命配置问题。
错误处理的最佳实践
- 不要忽略错误返回值，即使你觉得某个操作不会出错，也应该至少打印错误日志，避免后续排查问题没有线索。
- 错误应该尽早返回，不要在函数内部吞掉错误，除非你有明确的逻辑需要处理这个错误并且不影响上层流程。
- 给错误添加足够的上下文信息，比如操作的对象、执行的步骤，方便后续定位问题。
- 自定义错误类型时，尽量保持简洁，不要添加过多不必要的字段，避免错误类型过于复杂。
- 不要在defer中做复杂的错误处理，defer中的逻辑应该是简洁的清理操作，复杂的处理放在正常的流程中。
错误处理常见误区
很多开发者刚接触Go时会犯一些常见错误，比如把error当作异常处理，遇到错误就panic，或者使用空白标识符忽略错误返回值：
package main
import (
"os"
)
func wrongExample() {
// 错误示例：忽略错误返回值
os.Open("/data/nonexist.txt")
}
上面的代码中，Open函数返回的错误被直接忽略，如果文件打开失败，后续的文件操作都会出现问题，而且很难排查原因。正确的做法应该判断错误并处理。
另一个常见误区是在循环中处理错误时，没有正确处理错误的上下文，导致错误信息和实际执行的循环次数不匹配，建议在错误信息中带上当前循环的索引或者相关参数。
Go_error_handlingerror_interfacepanic_recoverdefer修改时间：2026-06-18 12:09:15