Golangerror接口详解与使用技巧

Go语言通过简洁而强大的error接口实现错误处理，摒弃了传统异常机制，转而用显式返回值让错误处理更明确可控；文章深入解析了error接口的本质、errors.New和fmt.Errorf的基础用法、自定义错误类型以携带上下文信息、%w包装实现错误链式追踪，以及errors.Is和errors.As提供的精准错误识别与类型提取能力——掌握这些核心技巧，你就能写出既清晰又健壮的Go错误处理逻辑。

在Golang中，error 是一个内置的接口类型，用于表示错误状态。任何实现了 Error() string 方法的类型都可以作为 error 使用。Go 语言没有异常机制，而是通过返回 error 值来处理错误，这使得错误处理更加明确和可控。

error 接口的基本定义

type error interface {
    Error() string
}

基本的 error 使用方式

最简单的做法是使用标准库中的 errors.New 或 fmt.Errorf 创建错误。

示例：

package main

import (
	"errors"
	"fmt"
)

func divide(a, b float64) (float64, error) {
	if b == 0 {
		return 0, errors.New("division by zero")
	}
	return a / b, nil
}

func main() {
	result, err := divide(10, 0)
	if err != nil {
		fmt.Println("Error:", err)
		return
	}
	fmt.Println("Result:", result)
}

Error: division by zero

自定义 error 类型

示例：带错误码和时间的自定义 error

package main

import (
	"fmt"
	"time"
)

type MyError struct {
	Code    int
	Message string
	Time    time.Time
}

func (e *MyError) Error() string {
	return fmt.Sprintf("[ERROR %d] %s at %v", e.Code, e.Message, e.Time)
}

func doSomething() error {
	return &MyError{
		Code:    500,
		Message: "something went wrong",
		Time:    time.Now(),
	}
}

func main() {
	err := doSomething()
	if err != nil {
		fmt.Println(err)
		// 可以类型断言获取具体信息
		if myErr, ok := err.(*MyError); ok {
			fmt.Printf("Code: %d, Msg: %s\n", myErr.Code, myErr.Message)
		}
	}
}

使用 fmt.Errorf 包装错误（Go 1.13+）

示例：

package main

import (
	"fmt"
)

func readFile() error {
	return fmt.Errorf("file not found")
}

func openConfig() error {
	err := readFile()
	return fmt.Errorf("failed to open config: %w", err)
}

func main() {
	err := openConfig()
	if err != nil {
		fmt.Println("Error:", err)
		// 判断是否包含某个底层错误
		if errors.Is(err, fmt.Errorf("file not found")) {
			fmt.Println("Root cause: file not found")
		}
	}
}

错误比较与判断

• errors.Is(err, target)：判断 err 是否等于目标错误
• errors.As(err, &target)：判断 err 是否为某自定义类型，并赋值

示例：

if errors.Is(err, os.ErrNotExist) {
	fmt.Println("File does not exist")
}

var myErr *MyError
if errors.As(err, &myErr) {
	fmt.Printf("Custom error code: %d\n", myErr.Code)
}

基本上就这些。Golang 的 error 设计简洁但足够灵活，合理使用能写出清晰可靠的错误处理逻辑。关键在于及时检查错误、恰当包装、必要时自定义类型以便区分不同错误场景。不复杂但容易忽略细节。

今天关于《Golangerror接口详解与使用技巧》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！