今天早些时候，golang/x/exp中默默的更新了一个名曰xerrors的包，这个包和同样处于golang/x/exp下的另一个名叫errors的包名字十分相似，就连介绍也都一致：

 Package errors implements functions to manipulate errors.

This package implements the Go 2 draft designs for error inspection and printing

从目前的情况来看，基本上错误的处理形式基本已经定型，处理方式则是类似于之前的另一个github.com/pkg/errors包，但是具体细节不尽相同。

如何处理error？

在之前介绍文章中提到过github.com/pkg/errors包的设计思路，那么在Go团队的实现中，这种思路也得到了继承。先从一个小例子开始：

package main

import (
	"fmt"

	"golang.org/x/exp/xerrors"
)

func raiseError() error {
	return xerrors.New("a new error")
}

func main() {
	err := xerrors.Errorf("raiseError: %w", raiseError())
	fmt.Println(err)
}

输出结果：

raiseError: a new error

看起来非常类似于之前github.com/pkg/errors的显示内容。而其中xerrors.Errorf则充当了之前errors.Wrap的功能。 其中值得一提的是%w，这个用于包装错误，后续验证错误中也会用到其中的值。

同时，这个包中也包含了几个非常有用的辅助函数，分别是：验证错误类型方法Is、错误类型转换方法As、错误关系链解除方法Opaque和提取内层错误方法Unwrap。我们可以用一个简单的演示来说明这种关系：

var (
	ErrBase = xerrors.New("a new error")
)

func main() {
	err := xerrors.Errorf("raiseError: %w", ErrBase)
	fmt.Println(ErrBase == ErrBase)                       // 地址相同
	fmt.Println(err == ErrBase)                           // 基于ErrBase包装之后不同
	fmt.Println(xerrors.Is(err, ErrBase))                 // 验证是否为基于ErrBase
	fmt.Println(xerrors.Opaque(err) == err)               // 解除关系链之后不为相同地址
	fmt.Println(xerrors.Is(xerrors.Opaque(err), ErrBase)) // 解除关系链之后无法确定关系
	fmt.Println(xerrors.Unwrap(err) == ErrBase)           // 获取内层错误为原错误，地址相同
}

输出结果为：

true
false
true
false
false
true

即便是在包裹多层之后，错误类型也能通过Is方法正确识别：

func main() {
	err := xerrors.Errorf("raiseError: %w", ErrBase)
	err2 := xerrors.Errorf("wrap#01: %w", err)
	err3 := xerrors.Errorf("wrap#02: %w", err2)
	fmt.Println(xerrors.Is(err, ErrBase))
	fmt.Println(xerrors.Is(err3, ErrBase)) // 能够正确识别关系，打印为true
}

如果需要打印详细的调用链路，则可以通过标准库fmt相关功能进行输出，比如Printf或者Sprintf等。

func main() {
	err := xerrors.Errorf("raiseError: %w", ErrBase)
	err2 := xerrors.Errorf("wrap#01: %w", err)
	err3 := xerrors.Errorf("wrap#02: %w", err2)
	fmt.Printf("%+v\n", err3)
}

输出链路如下：

wrap#02:
    main.main
        /.../error.go:16
  - wrap#01:
    main.main
        /.../error.go:15
  - raiseError:
    main.main
        /.../error.go:14
  - a new error:
    main.init
        /.../error.go:10

但是注意，使用%w进行包装时，仅能单次包装单个错误，比如下面这种两个错误同时包装时，是会无法识别的：

var (
	ErrBase  = xerrors.New("a new error")
	ErrBase2 = xerrors.New("another new error")
)

func main() {
	err := xerrors.Errorf("raiseError: %w, %w", ErrBase2, ErrBase2)
	fmt.Println(xerrors.Is(err, ErrBase))
	fmt.Println(xerrors.Is(err, ErrBase2))
}

落地使用

在具体项目实现中，如对外提供的库文件中，我建议可以参考其他语言的实现方式，定义一个特殊的基础错误类型ErrBase，所有其他错误类型均由此类型派生，则后续外部在使用过程中，只需通过xerros.Is判定错误类型，则可以快速判定错误是否来自于本包，并且可以借助此功能统一单独处理来自于此第三方包的异常。

如果你有其他的建议和疑问，也欢迎在留言区中留言讨论。另外，根据实际实现代码来看，其中还有一些边缘情况未考虑或者未做处理，由于是试验性库，本库在使用过程中需自行承担所带来的风险。