讲师中心 微信公众号

工具推荐

视频效率加速
AniShort
AniShort

AI短剧协同制作平台

立刻MV
立刻MV

低成本歌曲 MV、视频生成

Laper
Laper

剧本策划到成片协作

updream

一键生成高质量推广成片

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

云枫酱_3125

云枫酱_3125

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

|

247人浏览过

|

来源于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.Is 或 errors.As 判断原始错误时会失效

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

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

HTTP状态码查询
HTTP状态码查询

查询网站的HTTP响应状态码,判断网站是否正常访问、是否重定向、是否存在错误。适用于"HTTP状态码查询""网站状态查询""HTTP状态检测""网页状态码""网站响应码""301重定向查询"等请求。通过本地 Python 脚本调用网站HTTP状态查询接口,并使用环境变量中的专属 API Key。

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

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

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

  • 用 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.Unwrap 和 errors.Is 全部失效

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

有人担心 fmt.Errorf 比 errors.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 错误处理的复杂点从来不在“怎么创建”,而在于“怎么保持错误语义不丢失”。%w 和 errors.Is 是配套工具,但前提是——你得从第一行 fmt.Errorf 就用对。

热门AI工具

更多
UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

相关专题

更多
string转int
string转int

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

7499

2023.08.02

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

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

6384

2023.10.24

scripterror怎么解决
scripterror怎么解决

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

1069

2023.10.18

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

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

3500

2023.10.25

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

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

1938

2023.08.03

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

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

3184

2023.09.04

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

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

6384

2023.10.24

字符串介绍
字符串介绍

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

6529

2023.11.24

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

20

2026.11.12

热门下载

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

精品课程

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

共101课时 | 21.3万人学习

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

共39课时 | 4.9万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn