首页 > 后端开发 > Golang > 正文

Golang中errors包有哪些常用方法 详解Golang标准库的错误处理工具

P粉602998670
发布: 2025-08-18 13:01:01
原创
624人浏览过

在 go 语言中,错误处理通过 errors 包实现,主要包括创建、比较、提取和包装错误。1. 创建错误使用 errors.new() 或 fmt.errorf(),前者适用于固定信息,后者用于动态拼接;2. 错误比较推荐使用 errors.is(),它支持递归检查错误链,也可用 == 比较简单判断;3. 提取特定类型错误使用 errors.as(),可在错误链中查找目标类型;4. 错误包装通过 fmt.errorf 结合 %w 实现,保留原始错误信息,可用 errors.unwrap() 手动解包,但更推荐直接配合 errors.is() 或 errors.as() 使用。

Golang中errors包有哪些常用方法 详解Golang标准库的错误处理工具

在 Go 语言中,错误处理是一个非常核心的部分。标准库中的

errors
登录后复制
包虽然简单,但却是构建健壮程序的基础工具之一。它提供了一些基础功能来创建和比较错误。

Golang中errors包有哪些常用方法 详解Golang标准库的错误处理工具

创建自定义错误:使用
errors.New()
登录后复制
fmt.Errorf
登录后复制

最常用的两种方式是通过

errors.New()
登录后复制
或者
fmt.Errorf()
登录后复制
来生成错误:

Golang中errors包有哪些常用方法 详解Golang标准库的错误处理工具
  • errors.New("your error message")
    登录后复制

    这是最直接的方式,适合不需要格式化信息的场景。例如:

    err := errors.New("something went wrong")
    登录后复制
  • fmt.Errorf("error occurred: %v", err)
    登录后复制

    更加灵活,可以插入变量或拼接信息。注意,在 Go 1.13+ 中推荐加上
    %w
    登录后复制
    动词用于包装错误(后面会提到):

    Golang中errors包有哪些常用方法 详解Golang标准库的错误处理工具
    err := fmt.Errorf("failed to read file: %w", os.ErrNotExist)
    登录后复制
如果你只是想返回一个固定的错误字符串,用 errors.New 就够了;需要动态拼接时,优先考虑 fmt.Errorf。

错误比较:
errors.Is()
登录后复制
==
登录后复制

当我们需要判断某个错误是否是我们期望的那个时,可以用到以下方法:

立即学习go语言免费学习笔记(深入)”;

  • ==
    登录后复制
    比较
    直接比较两个错误是否相同。适用于简单的预定义错误,比如:

    if err == os.ErrNotExist {
        // 处理文件不存在的情况
    }
    登录后复制
  • errors.Is(err, target)
    登录后复制

    这是更推荐的做法,尤其当你处理的是被包装过的错误(wrap)。这个函数会递归地检查错误链,直到找到匹配的目标错误为止。

注意:如果错误是用

fmt.Errorf(...%w...)
登录后复制
包装过的,必须用
errors.Is()
登录后复制
才能正确识别原始错误。


获取底层错误:
errors.As()
登录后复制

有时候我们需要从一个可能被包装过的错误中提取特定类型的错误。这时候就要用到

errors.As()
登录后复制

慧中标AI标书
慧中标AI标书

慧中标AI标书是一款AI智能辅助写标书工具。

慧中标AI标书 120
查看详情 慧中标AI标书
var pathErr *fs.PathError
if errors.As(err, &pathErr) {
    fmt.Println("File path error:", pathErr.Path)
}
登录后复制

这段代码的意思是:尝试将

err
登录后复制
转换为
*fs.PathError
登录后复制
类型,并获取其中的信息。

  • errors.As()
    登录后复制
    会在错误链中查找是否有目标类型的错误。
  • 与类型断言不同,它不会因为中间层错误而失败。

使用场景举例:你调用了某个库的方法,它返回了一个封装后的错误,你想从中提取出具体的系统错误类型进行处理。


错误包装(Wrap)和 Unwrap

Go 1.13 引入了错误包装机制,使得你可以把一个错误包进另一个里面,同时保留原始错误信息。

  • 使用

    %w
    登录后复制
    格式符包装错误

    err := fmt.Errorf("read failed: %w", io.ErrUnexpectedEOF)
    登录后复制
  • 解包错误:

    errors.Unwrap()
    登录后复制
    可以手动解开一层包装,拿到里面的错误:

    cause := errors.Unwrap(err)
    登录后复制

不过大多数情况下你并不需要自己去一层层拆包,而是直接用前面提到的

errors.Is()
登录后复制
errors.As()
登录后复制
来处理。


基本上就这些。Go 的

errors
登录后复制
包设计得简洁但实用,掌握这几个关键方法,就能应对大多数错误处理场景了。

以上就是Golang中errors包有哪些常用方法 详解Golang标准库的错误处理工具的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
热门推荐
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号