使用 fmt.Errorf 可创建带格式的错误，%w 能包装原始错误以便用 errors.Is 和 errors.As 判断，错误信息应小写无句号，避免敏感信息，并推荐结合 zap 等结构化日志库输出。
在 Go 语言中，fmt 包是处理格式化输出的核心工具。虽然 Go 的错误设计提倡简洁和明确，但在开发过程中，我们经常需要构建带有上下文信息的错误，以便于调试和日志记录。使用 fmt.Errorf 配合格式化动词，可以灵活地生成带参数的错误信息。
1. 使用 fmt.Errorf 构建带格式的错误
fmt.Errorf 是最常用的创建格式化错误的方式。它返回一个符合 error 接口的值，同时支持占位符插入变量。
基本语法：
err := fmt.Errorf("failed to process user %d: %v", userID, err)
常见格式化动词：
立即学习“go语言免费学习笔记（深入）”；
- %d：整数
- %s：字符串
- %v：任意值的默认格式（推荐用于 error）
- %+v：结构体时包含字段名
- %T：值的类型
2. 包装错误并保留原始错误信息
从 Go 1.13 开始，fmt.Errorf 支持使用 %w 动词来包装错误（wrap error），这样可以保留原始错误，便于后续使用 errors.Is 和 errors.As 进行判断和提取。
示例：
if err != nil {
return fmt.Errorf("reading config file: %w", err)
}
之后可以通过：
if errors.Is(err, os.ErrNotExist) { ... }
来判断是否包含某个底层错误。
3. 错误输出的最佳实践
构建可读性强、结构清晰的错误信息有助于快速定位问题。以下是一些建议：
- 错误消息应以小写字母开头，不加句号（Go 社区惯例）
- 优先使用 %w 包装关键错误，保持错误链
- 避免泄露敏感信息（如密码、密钥）
- 在日志中输出完整错误时，使用 %+v 查看堆栈（如果配合第三方库如
pkg/errors）
4. 结合结构化日志输出更佳
虽然 fmt 适合简单场景，但在生产环境中，建议将格式化错误与结构化日志库（如 zap、logrus）结合使用。
例如：
logger.Error("database query failed",
zap.Int("user_id", userID),
zap.Error(err))
这种方式比纯字符串拼接更利于检索和监控。
基本上就这些。合理使用 fmt.Errorf 加上 %w 包装，既能保持错误语义，又能提供丰富上下文，是 Go 中错误处理的标准做法。
