快捷導(dǎo)航

一文詳解Golang中的errors包

更新時間：2023年07月11日 10:51:48 作者：路多辛

在 Golang 中，errors 包是用于處理錯誤的標(biāo)準(zhǔn)庫， errors 包提供的功能比較簡單，使用起來非常方便，接下來就具體講解一下 errors 包提供的幾個函數(shù)，感興趣的小伙伴跟著小編一起來看看吧

errors.New

func New(text string) error

錯誤處理是開發(fā)過程中必不可少的，使用 errors.New 函數(shù)可以創(chuàng)建一個表示特定錯誤的對象。接受一個字符串類型的參數(shù)（用于描述錯誤信息），返回一個 error 類型的值。例如：

package main
import "errors"
func main() {
	err := errors.New("invalid input")
}

error 類型是 builtin 包中定義的一個接口，定義如下：

type error interface {
	Error() string
}

可以看出此接口定義了一個基本的 Error 方法，用于返回錯誤的描述信息。

package main
import (
	"errors"
	"fmt"
)
func main() {
	err := errors.New("invalid input")
	errDesc := err.Error()
	fmt.Println(errDesc) // 輸出 invalid input
}

errors.Is

func Is(err, target error) bool

用于判斷給定的錯誤是否是目標(biāo)錯誤類型或者基于目標(biāo)錯誤類型包裝過的錯誤，會遞歸檢查錯誤鏈，直到找到目標(biāo)錯誤類型或者到達(dá)錯誤鏈的末尾。如果找到目標(biāo)錯誤類型，則返回true，否則返回false?？磦€例子：

package main
import (
	"errors"
	"fmt"
)
func main() {
	err := errors.New("invalid input")
	err1 := errors.New("invalid input")
	err2 := fmt.Errorf("err2: [%w]", err)
	fmt.Println(errors.Is(err1, err)) // false
	fmt.Println(errors.Is(err2, err)) // true
}

因為 err 和 err1 都是使用 errors.New 函數(shù)創(chuàng)建的，所以使用 Is 判斷會返回 false。err2 是基于 err 包裝出來的，所以使用 Is 判斷會返回 true。

errors.AS

func As(err error, target any) bool

用于將錯誤轉(zhuǎn)換為特定類型的錯誤，As 函數(shù)會檢查 err 是否是 target 指向的類型的實例，如果是，將該實例賦值給 target 并返回 true。否則返回 false?？磦€例子：

package main
import (
	"errors"
	"fmt"
)
type MyError struct {
	Message string
}
func (e *MyError) Error() string {
	return e.Message
}
func main() {
	err := &MyError{
		Message: "This is a custom error",
	}
	var target *MyError
	if errors.As(err, &target) {
		fmt.Println("Custom error found:", target.Message)
	} else {
		fmt.Println("Custom error not found")
	}
}

使用 errors.As 來檢查 err 是否是 MyError 類型的實例，并將實例賦值給 target。運行一下示例看下效果

$ go run main.go
Custom error found: This is a custom error

這個功能通常用于處理不同類型的錯誤，根據(jù)錯誤的類型采取對應(yīng)的處理方式。

errors.Unwrap

func Unwrap(err error) error

用于將一個錯誤對象展開，得到下一層錯誤對象，如果錯誤對象沒有下一層錯誤對象，則返回 nil?？磦€例子：

package main
import (
	"errors"
	"fmt"
)
func main() {
  originalErr := errors.New("original error")
	err := fmt.Errorf("error: %w", originalErr)
	unwrappedErr := errors.Unwrap(err)
	fmt.Println(unwrappedErr) // 輸出： original error
}

使用 fmt.Errorf 函數(shù)將 originalErr 做了一層包裝后得到 err，然后通過使用 Unwrap 將 err 解包并得包裝前的錯誤對象 originalErr。需要注意的是 Unwrap 只能展開被 fmt.Errorf 包裝的錯誤對象。如果想要展開其他類型的錯誤對象，可以使用類型斷言操作符 `.` 進(jìn)行類型斷言。