Golang使用fmt.Errorf生成自定义错误示例

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开发中非常实用的工具。