%w 是用于错误包装(Error Wrapping)的格式化动词。它是用于 fmt.Errorf 和 fmt.Sprintf 函数中的一个特殊格式化动词,用于将一个错误(或其他可打印的值)包装在一个新的错误中。
使用 %w 时,它会在格式化字符串中占据一个位置,并将其后的错误作为参数传递给 fmt.Errorf 或 fmt.Sprintf 函数。这将创建一个新的错误,包含了原始错误信息,并形成一个错误链。
下面是一个示例,展示了如何使用 %w 来进行错误包装:
package main
import (
"errors"
"fmt"
)
func doSomething() error {
return errors.New("something went wrong")
}
func main() {
err := doSomething()
// Wrap the original error with additional context
wrappedErr := fmt.Errorf("encountered an issue: %w", err)
fmt.Println(wrappedErr) // Output: encountered an issue: something went wrong
if err, ok := wrappedErr.(interface{ Unwrap() error }); ok {
// wrappedErr是error类型,只支持Error()方法,所以没办法直接调用Unwrap()。但是wrappedErr.(interface{ Unwrap() error })取出内部的数据就可以调用Unwrap()了
fmt.Println("internal error:", err.Unwrap())
}
fmt.Println(errors.Is(wrappedErr, err)) // Output: true
fmt.Println(errors.Is(err, fmt.Errorf("something went wrong"))) // Output: false
}
另外,还有一种interface{ Unwrap() []error },其实是多次用了%w的结果。