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 来包装已有错误。
立即学习“go语言免费学习笔记(深入)”;
使用 %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。
基本上就这些,简单但实用。


