Golang中使用errors.New创建错误的场景有哪些_Golang自定义错误对象说明

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 简洁高效。

与 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 适合轻量、固定文本的错误创建；复杂场景下建议自定义错误结构体，提升可维护性和扩展性。