pkg/errors 是 Go 语言中的一个常用错误处理库，它提供了更丰富的错误处理功能，特别是支持 堆栈跟踪 和 错误的包装。这个库使得错误变得更加易于调试和追踪。
pkg/errors 的主要功能包括：
Life is like a journey
pkg/errors你可以通过以下命令来安装 pkg/errors 库：
go get github.com/pkg/errors
pkg/errors 提供了 errors.Wrap 和 errors.WithMessage 方法，用于将错误进行包装，并附加额外的上下文信息。
package main
import (
"fmt"
"github.com/pkg/errors"
"os"
)
func someFunc() error {
return errors.New("an error occurred")
}
func main() {
err := someFunc()
if err != nil {
// Wrap the error with additional context
err = errors.Wrap(err, "while calling someFunc")
fmt.Println(err)
}
}
输出：
while calling someFunc: an error occurred
这样，你可以通过包装错误来提供更多上下文信息，让错误信息更具可读性和可追溯性。
pkg/errors 支持 fmt.Errorf 风格的错误格式化，可以通过 errors.New 和 errors.Wrap 使用格式化字符串：
package main
import (
"fmt"
"github.com/pkg/errors"
)
func someFunc() error {
return errors.New("something went wrong")
}
func main() {
err := someFunc()
if err != nil {
// Wrap the error with context and use formatting
err = errors.Wrapf(err, "error in someFunc: %s", "additional context")
fmt.Println(err)
}
}
输出：
error in someFunc: additional context: something went wrong
pkg/errors 还提供了 errors.Cause 来获取最原始的错误，同时也能通过 errors.Stack 获取堆栈信息，便于调试：
package main
import (
"fmt"
"github.com/pkg/errors"
)
func someFunc() error {
return errors.New("an error occurred")
}
func main() {
err := someFunc()
if err != nil {
// Wrap the error with a stack trace
err = errors.Wrap(err, "something went wrong")
// Print the error with the stack trace
fmt.Println(err)
}
}
输出将包括堆栈信息：
something went wrong: an error occurred
stack trace:
/path/to/your/file.go:12 (main.main)
/path/to/your/file.go:8 (main.someFunc)
errors.Cause）有时你可能想获取最初的错误，而不关心它是否被包装了。pkg/errors 提供了 Cause 方法来提取错误的根本原因：
package main
import (
"fmt"
"github.com/pkg/errors"
)
func someFunc() error {
return errors.New("the underlying error")
}
func main() {
err := someFunc()
if err != nil {
// Wrap the error
err = errors.Wrap(err, "wrap error with context")
// Get the original error
originalErr := errors.Cause(err)
fmt.Println("Original error:", originalErr)
}
}
输出：
Original error: the underlying error
你还可以定义自己的错误类型，并结合 pkg/errors 使用：
package main
import (
"fmt"
"github.com/pkg/errors"
)
type MyError struct {
Code int
Message string
}
func (e *MyError) Error() string {
return fmt.Sprintf("Error %d: %s", e.Code, e.Message)
}
func someFunc() error {
return &MyError{Code: 404, Message: "not found"}
}
func main() {
err := someFunc()
if err != nil {
// Wrap the custom error
err = errors.Wrap(err, "additional context")
fmt.Println(err)
}
}
输出：
additional context: Error 404: not found
pkg/errors 是 Go 语言中非常实用的一个错误处理库，它简化了错误的包装和堆栈信息的获取，使得错误的追踪和调试更加方便。它的主要功能包括：
Cause 获取原始错误。然而，值得注意的是，Go 1.13 之后，标准库 errors 引入了 Wrap 和 Is 等方法来处理错误的包装和检查，部分功能和 pkg/errors 类似，所以在新项目中，你可能会选择直接使用标准库的错误处理方法。