Golang 中的 Errors 包詳解,你都了解嗎?

在 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)錯誤類型或者到達錯誤鏈的末尾。如果找到目標(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 包裝的錯誤對象。如果想要展開其他類型的錯誤對象,可以使用類型斷言操作符 `.` 進行類型斷言。
小結(jié)
errors 包提供了一些簡單易用的函數(shù)來處理和獲取錯誤信息,借助 errors 包可以實現(xiàn)非常強大的錯誤處理功能。















 
 
 













 
 
 
 