首页 > Golang > Go教程

Golang自定义错误生成方法详解

时间：2025-12-13 16:37:34 235浏览收藏

推广推荐

支持 PC / 移动端，安全直达

怎么入门Golang编程？需要学习哪些知识点？这是新手们刚接触编程时常见的问题；下面golang学习网就来给大家整理分享一些知识点，希望能够给初学者一些帮助。本篇文章就来介绍《Golang自定义错误生成示例详解》，涉及到，有需要的可以收藏一下

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

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

在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)
  }
}

输出：

发生错误: 除数不能为零: 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开发中非常实用的工具。

本篇关于《Golang自定义错误生成方法详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！