fmt.Errorf用于创建带格式的错误,可添加上下文信息便于调试,如fmt.Errorf("除数不能为零: a=%d, b=%d", a, b)返回具体错误;还能包装已有错误,如fmt.Errorf("读取配置文件失败: %v", err)保留原始错误信息;但会丢失原始错误类型,需注意在需要类型判断时使用其他方式。

在Go语言中,fmt.Errorf 是生成自定义错误最常用的方式之一。它允许你在标准 error 类型的基础上添加上下文信息,比如格式化字符串,使错误更具体、便于调试。
基本用法:使用 fmt.Errorf 创建带格式的错误
fmt.Errorf 的用法类似于 fmt.Printf,但它返回一个 error 类型的对象。
- err := fmt.Errorf("无法处理用户ID: %d", userID)
- return err
示例代码:
func divide(a, b int) error {if b == 0 {
return fmt.Errorf("除数不能为零: a=%d, b=%d", a, b)
}
result := a / b
fmt.Printf("结果: %d\n", result)
return nil
}
func main() {
err := divide(10, 0)
if err != nil {
fmt.Println("发生错误:", err)
}
}
输出:
立即学习“go语言免费学习笔记(深入)”;
发生错误: 除数不能为零: a=10, b=0结合其他错误:增强原始错误信息
你还可以用 fmt.Errorf 包装已有的错误,添加更多上下文。
data, err := ioutil.ReadFile("config.json")if err != nil {
return fmt.Errorf("读取配置文件失败: %v", err)
}
这样不仅保留了原始错误(通过 %v 输出),还说明了出错场景,有助于排查问题。
注意:避免丢失错误类型信息
虽然 fmt.Errorf 很方便,但它会创建一个新的字符串错误,原始 error 的类型和结构会丢失。如果需要保留错误类型(例如用于 errors.Is 或 errors.As),建议在必要时使用 errors.Join 或自定义错误结构体。
但在大多数日常场景中,fmt.Errorf 提供了简洁清晰的错误描述方式。
基本上就这些。fmt.Errorf 简单直接,适合快速构建带有变量信息的错误提示,是Go开发中非常实用的工具。










