errors

New

创建错误。

Join

包装多个错误。

As

判断错误类型。

package main

import (
 "errors"
 "fmt"
 "io/fs"
 "os"
)

func main() {
 if _, err := os.Open("non-existing"); err != nil {
  var pathError *fs.PathError
  if errors.As(err, &pathError) {
   fmt.Println("Failed at path:", pathError.Path)
  } else {
   fmt.Println(err)
  }
 }

}

Is

不仅判断错误类型，还要判断错误值。

import (
 "errors"
 "fmt"
 "io/fs"
 "os"
)

func main() {
 if _, err := os.Open("non-existing"); err != nil {
  if errors.Is(err, fs.ErrNotExist) {
   fmt.Println("file does not exist")
  } else {
   fmt.Println(err)
  }
 }

}

Unwrap