errors.New适用于创建固定文本的简单错误,如参数校验失败时返回“除数不能为零”,无需额外字段;动态消息应使用fmt.Errorf,结构化错误需自定义类型实现error接口。

在Golang中,errors.New 是创建简单错误的最直接方式。它适用于不需要额外上下文或结构化信息的场景。当你只需要返回一个描述性的错误消息时,使用 errors.New 非常合适。
基本用法与适用场景
errors.New 接收一个字符串,返回一个实现了 error 接口的类型。常用于函数校验失败、状态非法、输入不合法等基础错误情况。
例如:
func divide(a, b float64) error {if b == 0 {
return errors.New("除数不能为零")
}
fmt.Println(a / b)
return nil
}
这种情况下,错误信息是固定的,没有需要携带的额外字段,使用 errors.New 简洁高效。
立即学习“go语言免费学习笔记(深入)”;
与 fmt.Errorf 的对比选择
当错误信息需要动态拼接时,推荐使用 fmt.Errorf,而 errors.New 更适合静态字符串。
比如:
- 静态错误:errors.New("配置文件未找到")
- 动态错误:fmt.Errorf("用户 %s 不存在", username)
若只是抛出预定义的错误提示,无需格式化变量,errors.New 更清晰且性能略优。
自定义错误类型的必要性
当需要携带错误码、时间戳、重试建议等附加信息时,应定义结构体实现 error 接口,而不是依赖 errors.New。
例如:
type MyError struct {Code int
Message string
Time time.Time
}
func (e *MyError) Error() string {
return fmt.Sprintf("[%d] %s at %v", e.Code, e.Message, e.Time)
}
// 使用
return &MyError{Code: 404, Message: "资源未找到", Time: time.Now()}
这种结构化错误便于程序判断错误类型,也利于日志分析和监控系统处理。
何时使用 errors.New
以下场景适合使用 errors.New:
- 函数内部简单校验失败,如参数为空、状态不满足
- 调用方仅需知道“发生了什么”,无需进一步区分错误细节
- 快速原型开发或小型工具函数中,追求代码简洁
- 配合 errors.Is 进行错误比较(Go 1.13+)
例如:
var ErrTimeout = errors.New("操作超时")if err != nil && errors.Is(err, ErrTimeout) {
// 处理超时逻辑
}
基本上就这些。errors.New 适合轻量、固定文本的错误创建;复杂场景下建议自定义错误结构体,提升可维护性和扩展性。










