golang中errors的方法

在 Go 语言中，errors 包提供了一些用于处理错误的基本方法。以下是 errors 包中的主要功能和方法：

1. errors.New

• 用法：创建一个新的错误值。
• 语法：

  func New(text string) error
  

2. errors.Is

• 用法：检查错误是否与特定错误相等。
• 语法：

  func Is(err error, target error) bool
  

3. errors.As

• 用法：将错误转型为指定类型。
• 语法：

  func As(err error, target interface{}) bool
  

4. errors.Unwrap

• 用法：获取错误的底层原因。
• 语法：

  func Unwrap(err error) error
  

5. fmt.Errorf

虽然不在 errors 包中，但常用于创建带格式的错误：

• 用法：创建一个格式化的错误。
• 语法：

  func Errorf(format string, args ...interface{}) error
  

示例代码

以下是一个简单的示例，展示如何使用这些方法：

package main

import (
    "errors"
    "fmt"
)

func main() {
    // 创建一个错误
    err1 := errors.New("original error")

    // 创建一个包装错误
    err2 := fmt.Errorf("an error occurred: %w", err1)

    // 检查错误
    if errors.Is(err2, err1) {
        fmt.Println("err2 contains err1")
    }

    // 获取底层错误
    if unwrappedErr := errors.Unwrap(err2); unwrappedErr != nil {
        fmt.Println("Unwrapped error:", unwrappedErr)
    }

    // 使用 As 方法
    var targetError *MyError
    if errors.As(err2, &targetError) {
        fmt.Println("err2 is of type *MyError")
    }
}

// 自定义错误类型示例
type MyError struct {
    msg string
}

func (e *MyError) Error() string {
    return e.msg
}

总结

• errors.New：创建新的错误。
• errors.Is：检查错误是否相等。
• errors.As：类型断言，检查错误类型。
• errors.Unwrap：获取底层错误原因。
• fmt.Errorf：创建格式化错误，常用 %w 来包装错误。

这些方法使得 Go 的错误处理变得更加灵活和强大。