Golang errors.New与fmt.Errorf的使用区别

云杰同学_1599

云杰同学_1599

2026-01-21

595人浏览

原创

该用 errors.New 时是需固定无变量错误描述且要轻量安全比较的场景;它不支持格式化和错误链,而 fmt.Errorf 通过 %w 动词实现标准错误包装与上下文嵌入,语义更清晰。

golang errors.new与fmt.errorf的使用区别

什么时候该用 errors.New?

当你只需要一个固定、无变量的错误描述时,errors.New 是最轻量的选择。它内部只是构造一个 *errors.errorString 结构体,开销极小,且返回的错误值可安全比较(相同字符串多次调用会得到相等的指针)。

  • 适合预定义错误常量,比如 var ErrInvalidInput = errors.New("invalid input")
  • 不支持格式化,传入含变量的拼接字符串(如 "file " + name + " not found")会让代码难读、易出错
  • 无法包装底层错误,也不支持 Go 1.13+ 的错误链(%w)

为什么必须用 fmt.Errorf 而不是拼接字符串再传给 errors.New?

手动拼接字符串再喂给 errors.New 看似可行,但实际绕开了标准错误处理的关键能力:上下文嵌入与错误包装。

  • fmt.Errorf("failed to parse %s: %w", filename, err) 中的 %w 可以保留原始错误,供 errors.Is 或 errors.Unwrap 追踪
  • 直接拼接丢失类型信息和原始错误引用,调试时看不到“谁抛出的原始错误”
  • fmt.Errorf 底层其实也是调用 errors.New,但它先完成格式化,再构造错误——你省去的是手动 fmt.Sprintf + errors.New 两步,还获得标准语义

fmt.Errorf 的 %w 动词到底怎么用?

%w 是 Go 1.13 引入的专用动词,专用于包装(wrap)另一个 error 值。它不是字符串插值,而是建立错误链关系。

Golang Uber Dig
Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等

下载
func readFile(filename string) error {
    f, err := os.Open(filename)
    if err != nil {
        return fmt.Errorf("failed to open %s: %w", filename, err)
    }
    defer f.Close()
    return nil
}

// 调用方可以这样检查原始错误:
if errors.Is(err, os.ErrNotExist) {
    // 处理文件不存在的情况
}
  • 只有 %w 参数必须是 error 类型,其他占位符(如 %s、%d)照常用
  • 一个 fmt.Errorf 中最多只能有一个 %w;多个包装请用 fmt.Errorf("...: %w", errors.Join(err1, err2))(Go 1.20+)
  • 忘记加 %w 而写成 %s,会导致原始错误被转成字符串丢弃,再也无法用 errors.Is 判断

性能差异大吗?要不要为简单错误刻意避免 fmt.Errorf?

在绝大多数业务场景下,差异可忽略。但要注意:这不是“性能问题”,而是“语义清晰度问题”。

  • errors.New 零分配(仅一次结构体指针),fmt.Errorf 至少有一次字符串格式化分配 —— 但在 HTTP handler 或数据库操作里,这点开销远小于 I/O 本身
  • 真正该警惕的是滥用 fmt.Errorf 包装非错误值,比如 fmt.Errorf("status code: %d", code)(code 不是 error)—— 这破坏了错误链,也误导调用方
  • 如果你发现某处高频创建错误(如循环内),且内容完全静态,才值得考虑缓存 errors.New(...) 的结果,而不是每次新建

错误链和上下文不是锦上添花的功能,而是 Go 错误处理的基础设施。用错 %w 或回避它,会在排查生产问题时多花几倍时间翻日志找根因。

golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

golang

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2024.02.23

519

5

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

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

2024.02.23

616

5

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

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

2024.02.23

1216

5

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

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

2024.03.05

791

5

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

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

2024.05.21

1786

6

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

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

2025.06.09

5054

18

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

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

2025.06.10

2334

13

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

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

2025.06.17

4206

17

golang数组大全
golang数组大全

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

2025.06.20

5326

22

热门下载

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

精品课程

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