fmt.Errorf用于创建带格式的错误信息，支持插入变量和用%w包装原始错误以保留上下文，适用于需添加上下文或构建错误链的场景。

在 go 语言中，fmt.Errorf 是创建带有格式化信息的错误最常用的方式。它允许你在返回 error 类型的同时插入动态值，使错误信息更具可读性和调试价值。

基本用法

fmt.Errorf 的使用方式和 fmt.printf 非常相似，但它返回一个 error 类型而不是打印输出。

示例：

err := fmt.Errorf("无法打开文件: %s", filename)
这会生成一个 error 类型的对象，其内容是 “无法打开文件: xxx.txt”（假设 filename 是 “xxx.txt”）。

结合 %w 包装原始错误

从 Go 1.13 开始，fmt.Errorf 支持使用 %w 动词来包装另一个错误。这能保留原始错误的上下文，并支持后续用 errors.Is 或 errors.As 判断错误类型。

比格设计

比格设计是135编辑器旗下一款一站式、多场景、智能化的在线图片编辑器

124

查看详情

示例：

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

这里通过 %w 将底层的文件打开错误包装进去。调用者可以使用 errors.Unwrap 或 errors.Is 检查是否包含特定错误（如 os.ErrNotExist）。

立即学习“go语言免费学习笔记（深入）”；

什么时候该用 fmt.Errorf

• 需要向错误中插入变量（如路径、ID、状态码等）时
• 想为底层错误添加上下文说明，又不希望完全隐藏原错误
• 构建清晰的错误链以便日志追踪

注意：如果只是传递错误而无需添加信息，直接返回原 error 更合适。

基本上就这些。fmt.Errorf 简单但很实用，合理使用 %w 能让错误处理更结构化。