0

0

Golang errors包常用方法 详解New、Wrap和Unwrap

P粉602998670

P粉602998670

发布时间:2025-08-28 09:25:01

|

910人浏览过

|

来源于php中文网

原创

Go 1.13起errors包支持错误包装,New创建基础错误,Wrap(来自pkg/errors)添加上下文并保留原错误,Unwrap解析错误链,结合Is、As可遍历判断,建议用fmt.Errorf搭配%w实现标准错误包装,提升错误追踪与维护性。

golang errors包常用方法 详解new、wrap和unwrap

在 Go 语言中,错误处理是程序设计的重要组成部分。虽然 Go 1.13 之前的标准库 errors 包功能较为基础,但从 Go 1.13 开始引入了对错误包装(wrapping)的支持,使得错误链的构建和解析成为可能。本文将详细讲解 errors 包中常用的三个方法:New、Wrap 和 Unwrap,并说明它们的使用场景和注意事项。

New:创建基础错误

errors.New 是最基础的错误创建方式,用于生成一个简单的、不可包装的错误值。

它接收一个字符串,返回一个实现了 error 接口的类型。

示例:

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

err := errors.New("something went wrong")

这个错误只是一个纯文本信息,不包含堆栈信息,也无法携带底层错误。适用于不需要上下文或嵌套错误的场景。

注意:使用 errors.New 创建的错误无法被 Wrap,因为它不支持错误包装机制。

Wrap:包装错误,保留上下文

虽然标准库 errors 包本身没有提供 Wrap 方法,但社区广泛使用的 github.com/pkg/errors 包提供了这一功能。它是实际开发中处理错误链的常用工具

errors.Wrap 的作用是将一个已有错误包装起来,附加额外的上下文信息(如当前操作的描述),同时保留原始错误,形成错误链。

示例:

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

if err != nil {

  return errors.Wrap(err, "failed to read config file")

}

这样,当错误最终被打印时,可以通过 errors.Cause%+v 格式获取完整的错误链和堆栈信息。

万彩商图
万彩商图

专为电商打造的AI商拍工具,快速生成多样化的高质量商品图和模特图,助力商家节省成本,解决素材生产难、产图速度慢、场地设备拍摄等问题。

下载

使用 Wrap 能帮助开发者定位错误源头,尤其在多层调用中非常有用。

Unwrap:提取被包装的错误

Go 1.13+ 在标准库 errors 包中引入了 Unwrap 函数,用于从包装错误中提取出底层错误。

如果一个错误实现了 Unwrap() error 方法,那么它就是一个可展开的包装错误。

示例:

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

if err != nil {

  wrappedErr := fmt.Errorf("operation failed: %w", err)

}

这里使用了 %w 动词来创建一个可展开的错误。之后可以使用 errors.Unwrap 获取原始错误:

original := errors.Unwrap(wrappedErr)

还可以使用 errors.Iserrors.As 遍历整个错误链,判断是否包含某个特定错误或是否能转换为某个类型。

例如:

if errors.Is(err, os.ErrNotExist) {

  log.Println("file does not exist")

}

总结与建议

标准库 errors 提供了基础的错误创建和解析能力,而 github.com/pkg/errors 则增强了错误包装和堆栈追踪功能。

在现代 Go 项目中:

  • errors.New 创建简单错误
  • fmt.Errorf + %w 实现标准库兼容的错误包装
  • errors.Unwraperrors.Iserrors.As 进行错误判断和提取
  • 若需堆栈信息,可引入 pkg/errors,但注意与标准库的兼容性

基本上就这些。掌握这些方法,能让你的 Go 错误处理更清晰、更可维护。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

177

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

225

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

336

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

207

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

388

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

194

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

189

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

191

2025.06.17

python设置中文版教程合集
python设置中文版教程合集

本专题整合了python改成中文版相关教程,阅读专题下面的文章了解更多详细内容。

1

2026.01.05

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Django 教程
Django 教程

共28课时 | 2.8万人学习

SciPy 教程
SciPy 教程

共10课时 | 1万人学习

Sass 教程
Sass 教程

共14课时 | 0.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

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