如何使用Golang的errors包_Golang标准错误库功能与应用示例-Golang-PHP中文网

如何使用Golang的errors包_Golang标准错误库功能与应用示例

P粉602998670

发布： 2025-11-16 20:51:05

原创

403人浏览过

Go 1.13增强errors包，支持错误包装（%w）、errors.Is判断相等、errors.As提取类型，推荐底层返回具体错误、中间层添加上下文、顶层分类处理，提升错误可读性与维护性。

如何使用golang的errors包_golang标准错误库功能与应用示例

Go语言从1.13版本开始对 errors 包进行了增强，引入了错误包装（error wrapping）、错误判定和错误类型提取等功能，使错误处理更加灵活和语义化。合理使用 errors 包能提升程序的可维护性和调试效率。

错误包装：Wrap 和 Unwrap

在实际开发中，底层函数返回错误时，上层函数往往需要添加上下文信息以便于定位问题。Go 通过 %w 动词实现错误包装。

注意：%w 只能用于 fmt.Errorf，且只能包装一个错误。

示例：

package main

import (
    "errors"
    "fmt"
)

func readFile() error {
    return fmt.Errorf("读取文件失败: %w", errors.New("文件不存在"))
}

func processFile() error {
    return fmt.Errorf("处理文件出错: %w", readFile())
}

func main() {
    err := processFile()
    fmt.Println(err) // 输出：处理文件出错: 读取文件失败: 文件不存在
}

登录后复制

判断错误是否相等：errors.Is

当需要判断某个错误链中是否包含特定错误时，使用 errors.Is 比 == 更安全，因为它会递归检查被包装的错误。

立即学习“go语言免费学习笔记（深入）”；

示例：

target := errors.New("连接超时")
err := fmt.Errorf("网络请求失败: %w", target)

if errors.Is(err, target) {
    fmt.Println("捕获到连接超时错误")
}

登录后复制

即使错误被多层包装，errors.Is 也能正确匹配目标错误。

AppMall应用商店

AI应用商店，提供即时交付、按需付费的人工智能应用服务

查看详情

提取特定类型的错误：errors.As

当错误链中可能包含自定义结构体错误时，可用 errors.As 提取对应类型的变量，便于访问其字段或方法。

示例：

type MyError struct {
    Code int
    Msg  string
}

func (e *MyError) Error() string {
    return fmt.Sprintf("错误码 %d: %s", e.Code, e.Msg)
}

func doSomething() error {
    return fmt.Errorf("操作失败: %w", &MyError{Code: 404, Msg: "未找到资源"})
}

func main() {
    err := doSomething()
    var myErr *MyError
    if errors.As(err, &myErr) {
        fmt.Printf("错误码: %d, 消息: %s\n", myErr.Code, myErr.Msg)
    }
}

登录后复制

这段代码成功从包装错误中提取出 *MyError 类型实例。