Golang使用errors New创建错误是否合理_Golang errors New使用场景说明

errors.New适用于静态错误场景,如固定消息、包级变量定义,配合errors.Is进行错误判断;需动态信息时应选用fmt.Errorf。

在 Go 语言中,errors.New 是创建简单错误的最基础方式之一。它是否“合理”取决于使用场景——对于不需要携带额外信息的错误,errors.New 不仅合理,而且推荐。

errors.New 的基本用法

errors.New 接收一个字符串并返回一个实现了 error 接口的类型。它的实现非常轻量,适用于快速构造一个静态错误消息。

import "errors"

func divide(a, b int) (int, error) {
    if b == 0 {
        return 0, errors.New("division by zero")
    }
    return a / b, nil
}

这种写法清晰、直接,适合大多数基础校验场景。

适合使用 errors.New 的场景

  • 静态错误信息:当错误原因固定,不需要动态参数时,比如 “invalid input”、“not found”。
  • 包内部简单校验:函数逻辑简单,出错路径明确,无需堆栈追踪或上下文信息
  • 公共 API 的标准错误:可将 errors.New 创建的错误变量定义为包级变量,供外部判断使用。
var ErrInvalidInput = errors.New("invalid input")

func validate(s string) error {
    if s == "" {
        return ErrInvalidInput
    }
    return nil
}

这种方式便于调用方通过 errors.Is 判断错误类型:

if errors.Is(err, ErrInvalidInput) {
    // 处理特定错误
}

不适合使用 errors.New 的情况

  • 需要携带上下文信息:如文件名、行号、具体数值等,此时应使用 fmt.Errorf
  • 链式错误处理:Go 1.13+ 支持错误包装,应使用 fmt.Errorf("%w", err) 向上层传递底层错误。
  • 需要结构化错误数据:例如 HTTP 状态码、错误代码等,建议自定义 error 类型。

与 fmt.Errorf 的对比

当错误信息需要动态拼接时,fmt.Errorf 更合适:

if !valid {
    return fmt.Errorf("value %q is not valid", value)
}

errors.New("not valid") 无法插入变量,灵活性差。

基本上就这些。在合适的地方用 errors.New,保持代码简洁;需要更多信息时,选择更强大的工具。合理与否,关键看是否匹配需求。