fmt.Errorf用于创建带格式化上下文的错误，支持%s、%d等动词；自Go 1.13起可用%w包装底层错误，保留错误链，便于用errors.Is或errors.As判断原始错误类型；但fmt.Errorf不记录堆栈，需结合github.com/pkg/errors等库通过WithStack添加调用栈信息以实现完整错误追踪。
在Go语言中，fmt.Errorf 是创建带有格式化信息的错误最常用的方式之一。它允许你在返回错误时加入上下文信息，比如变量值、操作类型等，从而提升调试和日志排查效率。
基本用法：使用 fmt.Errorf 创建带上下文的错误
fmt.Errorf 的语法与 fmt.Printf 类似，支持格式动词（如 %s、%d、%v），但返回的是 error 类型。
常见写法如下：
if value < 0 {
return fmt.Errorf("无效数值: %d", value)
}
这比直接返回 errors.New("无效数值") 更具可读性，能快速定位问题来源。
立即学习“go语言免费学习笔记（深入）”；
结合错误包装传递上下文（Go 1.13+）
从 Go 1.13 开始，errors 包引入了错误包装（error wrapping）机制，fmt.Errorf 支持通过 %w 动词将底层错误嵌入新错误中，保留原始错误链。
例如：
简单易用的 GitCode API SKILL，提供 CLI 和轻量级 Python SDK 两种调用方式，用于与 GitCode 的 REST API 进行交互。支持加密访问令牌、异步调用以及完善的类型提示。 - 文档：https://gitcode-api.readthedocs.io/ - PyPI 页面：https://pypi.org/project/gitcode-api - GitHub 仓库：https://github.com/Trenza1ore/GitCode-API
_, err := os.Open("config.json")
if err != nil {
return fmt.Errorf("读取配置文件失败: %w", err)
}
这样上层调用者可以通过 errors.Is 或 errors.As 判断原始错误类型，同时保留了上下文信息。
输出堆栈信息的建议方式
需要注意的是，fmt.Errorf 本身不记录堆栈追踪信息。如果需要堆栈跟踪，推荐使用第三方库，如 github.com/pkg/errors 或 go.uber.org/zap 配合 stack trace。
例如使用 pkg/errors：
import "github.com/pkg/errors"
_, err := SomeOperation()
if err != nil {
return errors.WithStack(fmt.Errorf("业务处理失败: %v", err))
}
</font>
或者更简洁地：
return errors.WithStack(err)
这类库会在创建或包装错误时自动捕获当前调用栈，便于排查深层错误源头。
基本上就这些。fmt.Errorf 适合日常错误构造和上下文添加，若需堆栈追踪，则应结合专用错误库。标准库设计强调简洁，因此不内置堆栈功能，但通过组合方式仍可实现丰富错误处理逻辑。
