Golang中fmt.Errorf用法详解

一分耕耘，一分收获！既然都打开这篇《Golang中使用fmt.Errorf生成错误的方法》，就坚持看下去，学下去吧！本文主要会给大家讲到等等知识点，如果大家对本文有好的建议或者看到有不足之处，非常欢迎大家积极提出！在后续文章我会继续更新Golang相关的内容，希望对大家都有所帮助！

fmt.Errorf用于生成带格式的错误，支持插入动态值和包装原始错误，适合需上下文信息的场景。

在Golang中，fmt.Errorf 是一个常用的方法，用于创建带有格式化信息的错误。它和 fmt.Printf 类似，但返回的是一个 error 类型的值，适用于需要传递上下文或动态信息的错误场景。

基本用法

fmt.Errorf 接收一个格式字符串和对应的参数，生成一个符合 error 接口的值。你可以像使用 printf 一样插入变量：

err := fmt.Errorf("无法打开文件: %s", filename)
if err != nil {
    log.Println(err)
}

上面代码会输出类似：「无法打开文件: config.json」。这个 err 是一个 error 类型，可以直接返回或记录。

结合错误上下文

有时候你不仅要描述错误，还想保留原始错误信息。可以用 %v 或 %w 来包装已有错误。

使用 %w 可以创建一个可展开的错误（wrapped error），支持 errors.Is 和 errors.As 判断：

_, err := os.Open(filename)
if err != nil {
    return fmt.Errorf("读取配置文件失败: %w", err)
}

这样调用方可以通过 errors.Unwrap 或 errors.Is 检查原始错误类型，比如判断是否是文件不存在（os.ErrNotExist）。

何时使用 fmt.Errorf

• 需要向错误中插入动态值，如文件名、ID、状态码等
• 想为底层错误添加上下文，帮助定位问题
• 不希望直接暴露底层错误细节，但又要保留追溯能力（用 %w）

注意：如果只是静态错误，建议使用 errors.New 更高效；只有需要格式化或包装时才用 fmt.Errorf。

以上就是《Golang中fmt.Errorf用法详解》的详细内容，更多关于的资料请关注golang学习网公众号！