在 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 的错误处理变得更加灵活和强大。