快捷導(dǎo)航

一文詳解Golang中的errors包

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

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

errors.New

func New(text string) error

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

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

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

type error interface {
	Error() string
}

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

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

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

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
}

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

errors.AS

func As(err error, target any) bool

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

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 類型的實(shí)例，并將實(shí)例賦值給 target。運(yùn)行一下示例看下效果

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

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

errors.Unwrap

func Unwrap(err error) error

用于將一個(gè)錯(cuò)誤對(duì)象展開，得到下一層錯(cuò)誤對(duì)象，如果錯(cuò)誤對(duì)象沒有下一層錯(cuò)誤對(duì)象，則返回 nil?？磦€(gè)例子：

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 解包并得包裝前的錯(cuò)誤對(duì)象 originalErr。需要注意的是 Unwrap 只能展開被 fmt.Errorf 包裝的錯(cuò)誤對(duì)象。如果想要展開其他類型的錯(cuò)誤對(duì)象，可以使用類型斷言操作符 `.` 進(jìn)行類型斷言。