0

0

Golang的errors库如何创建自定义错误 演示错误包装与解包的最佳实践

P粉602998670

P粉602998670

发布时间:2025-08-23 10:17:01

|

1013人浏览过

|

来源于php中文网

原创

golang 中,错误处理应优先使用结构体实现 error 接口以携带额外信息,1. 自定义错误类型通过实现 error() 方法支持类型判断与信息扩展;2. 简单错误可用 errors.new 或 fmt.errorf,但不便于类型提取;3. 使用 fmt.errorf 的 %w 动词包装错误可保留原始信息;4. 解包错误可通过 errors.unwrap、errors.is 和 errors.as 遍历错误链进行匹配或类型提取;5. 实践中应优先使用 errors.as 判断类型,避免随意包装无上下文的错误,关键路径添加上下文再包装,并避免字符串比较以提升可靠性与可维护性。

Golang的errors库如何创建自定义错误 演示错误包装与解包的最佳实践

在 Golang 中,错误处理是程序设计的重要组成部分。

errors
库提供了创建、包装和解包错误的能力,让我们可以写出更清晰、可维护的错误逻辑。下面我们就来看看如何使用
errors
包来创建自定义错误,并演示错误包装与解包的最佳实践。

Golang的errors库如何创建自定义错误 演示错误包装与解包的最佳实践

自定义错误类型:实现 error 接口

最基础的方式是通过定义一个结构体并实现

error
接口的
Error() string
方法:

Golang的errors库如何创建自定义错误 演示错误包装与解包的最佳实践
type MyError struct {
    Msg string
}

func (e MyError) Error() string {
    return "MyError: " + e.Msg
}

这样你就可以像使用标准错误一样使用它:

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

err := MyError{"something went wrong"}
fmt.Println(err)

这种方式适合需要携带额外信息的场景,比如错误码、状态、发生位置等。你可以扩展这个结构体,加入更多字段以供后续处理。

Golang的errors库如何创建自定义错误 演示错误包装与解包的最佳实践

使用 errors.New 和 fmt.Errorf 创建简单错误

对于不需要附加额外信息的错误,直接使用

errors.New
就够用了:

err := errors.New("this is a simple error")

如果需要格式化错误信息,可以用

fmt.Errorf

err := fmt.Errorf("invalid value: %d", val)

但要注意的是,这两种方式创建的错误都是“裸”的字符串错误,不便于做类型判断或提取上下文信息。所以,在需要做错误类型区分时,还是建议用上面的结构体方式。

Lifetoon
Lifetoon

免费的AI漫画创作平台

下载

错误包装(Wrap):保留原始错误信息

Go 1.13 引入了

fmt.Errorf
%w
动词来进行错误包装:

err := fmt.Errorf("failed to read config: %w", originalErr)

这会把

originalErr
包装进新的错误中,方便后续调用者使用
errors.Unwrap()
errors.As()
提取原始错误。

注意:只有使用 %w 格式符包装的错误才能被正确解包。其他方式(如拼接字符串)无法保留原始错误结构。

错误解包(Unwrap):提取原始错误进行判断

如果你得到了一个被包装过的错误,想判断它是否是由某个特定错误引起的,可以用以下方法:

  • errors.Unwrap(err)
    :获取包装错误的下一层错误。
  • errors.Is(err, target)
    :判断某层错误是否等于目标错误。
  • errors.As(err, &target)
    :判断某层错误是否是指定类型的错误。

例如:

if errors.Is(err, os.ErrNotExist) {
    // 处理文件不存在的情况
}

或者检查自定义错误类型:

var myErr *MyError
if errors.As(err, &myErr) {
    fmt.Println("Got a MyError with message:", myErr.Msg)
}

这些方法会自动遍历整个错误链,直到找到匹配项为止,非常实用。


实践建议:怎么用才合理?

  1. 优先使用 errors.As 而不是 type switch
    因为

    errors.As
    可以处理嵌套包装的错误,而 type switch 只能判断当前层级的错误类型。

  2. 不要随意包装所有错误
    如果你只是传递错误而不加任何上下文信息,就不需要用

    %w
    。否则会让错误链变得复杂且难以理解。

  3. 在关键路径上添加上下文信息再包装
    比如在函数调用栈的高层加上操作失败的原因,这样调试时更容易定位问题。

  4. 避免只比较错误字符串
    字符串比较不稳定,容易因为拼写错误或语句变化而出错。应该尽量使用类型或变量对比。


基本上就这些。Golang 的错误机制虽然看起来简单,但在实际项目中要处理得当,还是要靠合理的包装和解包策略。用好

errors
包提供的工具,可以让你的错误处理更清晰、更可靠。

相关专题

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

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

174

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、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

335

2024.02.23

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

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

206

2024.03.05

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

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

388

2024.05.21

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

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

193

2025.06.09

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

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

188

2025.06.10

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

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

191

2025.06.17

php源码安装教程大全
php源码安装教程大全

本专题整合了php源码安装教程,阅读专题下面的文章了解更多详细内容。

65

2025.12.31

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
golang socket 编程
golang socket 编程

共2课时 | 0.1万人学习

nginx浅谈
nginx浅谈

共15课时 | 0.8万人学习

golang和swoole核心底层分析
golang和swoole核心底层分析

共3课时 | 0.1万人学习

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

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