0

0

Go中errors.New和fmt.Errorf区别_Go错误创建方式对比

P粉602998670

P粉602998670

发布时间:2026-01-17 17:12:09

|

227人浏览过

|

来源于php中文网

原创

errors.New仅支持固定字符串,适合全局常量错误;fmt.Errorf支持格式化和%w包装,可构建错误链并保持语义,适用于需动态上下文的场景。

go中errors.new和fmt.errorf区别_go错误创建方式对比

errors.New 只能传固定字符串,不能格式化

errors.New 是最轻量的错误创建方式,它只接受一个 string 参数,内部直接构造一个不可变的 errorString 实例。这意味着你没法往里面塞变量、时间戳、文件名这类动态内容。

  • ✅ 适合定义全局常量错误,比如 var ErrNotFound = errors.New("not found")
  • ❌ 一旦写死就无法注入上下文,像 errors.New("failed to open " + filename) 这种拼接是反模式——既难读又易出错(空格、引号、类型转换都可能翻车)
  • ⚠️ 它不支持 %w 包装语法,无法形成错误链,后续用 errors.Iserrors.As 判断原始错误时会失效

fmt.Errorf 支持格式化和错误包装(%w)

fmt.Errorf 本质是 fmt.Sprintf + errors.New 的组合,所以它天然支持占位符和任意类型的参数。更重要的是,从 Go 1.13 起,它支持 %w 动词,让错误可以“包裹”另一个错误,保留原始调用和语义。

  • ✅ 动态构建错误信息:例如 fmt.Errorf("read config: %w", io.ErrUnexpectedEOF)
  • ✅ 错误链友好:被 %w 包裹的错误可用 errors.Is(err, io.ErrUnexpectedEOF) 精准识别,哪怕中间套了三四层
  • ⚠️ 不要滥用 %v%s 打印 error 值本身(比如 fmt.Errorf("wrap: %s", err)),这会丢失原始 error 类型和包装关系,errors.Is 就失效了

什么时候该用哪个?看错误是否需要携带上下文

选型不是看“哪个更高级”,而是看错误值是否需要表达「发生了什么 + 在哪发生的 + 因为什么」。简单说:

Text-To-Song
Text-To-Song

免费的实时语音转换器和调制器

下载
  • errors.New:定义包级公共错误常量(如 ErrInvalidInput)、单元测试中造桩、或者错误信息完全静态且永不变化
  • fmt.Errorf:日志里带文件名/行号、HTTP handler 中返回带状态码的错误、封装底层库错误(如 os.Open 返回的 *os.PathError)、需要支持重试或分类处理的业务错误
  • ⚠️ 混用陷阱:不要在同一个错误链里交替用两者做包装。比如 fmt.Errorf("outer: %w", errors.New("inner")) 没问题,但反过来 errors.New(fmt.Sprintf("outer: %v", innerErr)) 会切断错误链,errors.Unwraperrors.Is 全部失效

性能差异几乎可忽略,别为这个纠结

有人担心 fmt.Errorferrors.New 慢,因为涉及格式化。实际在绝大多数场景下,这种开销远小于一次系统调用(比如磁盘 I/O 或网络请求)。而且 Go 编译器对简单格式化(如 "%s")做了优化,甚至能内联。

  • ✅ 微基准测试显示:100 万次 fmt.Errorf("hello")errors.New("hello") 耗时差不到 50ns/次
  • ❌ 真正影响性能的是错误频繁创建+panic+recover,而不是选哪个构造函数
  • ? 记住:错误对象本身是 cheap 的;昂贵的是你为它写的日志、监控上报、或用户提示逻辑
package main

import (
	"errors"
	"fmt"
	"io"
)

func main() {
	// ✅ 正确:用 fmt.Errorf 包装底层错误,保留可判断性
	original := io.ErrUnexpectedEOF
	wrapped := fmt.Errorf("decode JSON failed: %w", original)

	if errors.Is(wrapped, io.ErrUnexpectedEOF) {
		fmt.Println("识别成功") // 会打印
	}

	// ❌ 错误:用 errors.New + 字符串拼接,断开错误链
	broken := errors.New("decode JSON failed: " + original.Error())
	if errors.Is(broken, io.ErrUnexpectedEOF) {
		fmt.Println("不会执行到这里")
	}
}
Go 错误处理的复杂点从来不在“怎么创建”,而在于“怎么保持错误语义不丢失”。%werrors.Is 是配套工具,但前提是——你得从第一行 fmt.Errorf 就用对。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

318

2023.08.02

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1465

2023.10.24

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

187

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

280

2023.10.25

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

257

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

208

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1465

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

619

2023.11.24

高德地图升级方法汇总
高德地图升级方法汇总

本专题整合了高德地图升级相关教程,阅读专题下面的文章了解更多详细内容。

40

2026.01.16

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 8.3万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 3.2万人学习

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

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