如何在Golang中使用errors.New创建错误_Golang标准错误创建方法

9次阅读

Errors.New生成不可变静态错误,底层为只读字符串,适合预定义固定错误;应直接传字符串字面量,避免运行时拼接以保证==比较有效。

如何在Golang中使用errors.New创建错误_Golang标准错误创建方法

errors.New 生成的是不可变的静态错误

errors.New 返回一个实现了 error 接口的私有结构体,其底层是只读字符串。它不携带、不支持格式化参数、也不能动态拼接上下文——所有内容必须在调用时完全确定。

适合场景:预定义的、固定不变的错误标识,比如协议错误、状态非法等。

  • 错误值可安全用于 == 比较(因为是同一地址的指针或相同字符串的复用)
  • 不能用 sprintf 拼接后传给 errors.New,否则每次调用都生成新对象== 判定失效
  • 若需带变量信息,应改用 fmt.Errorf 或第三方库如 github.com/pkg/errors

正确使用 errors.New 的典型写法

直接传入纯字符串字面量,避免运行时拼接:

var (     ErrInvalidID   = errors.New("invalid user ID")     ErrNotFound    = errors.New("resource not found")     ErrPermission  = errors.New("insufficient permission") )

在函数中返回时也保持原样:

立即学习go语言免费学习笔记(深入)”;

func FindUser(id int) (*User, error) {     if id <= 0 {         return nil, ErrInvalidID // 直接返回变量,非 errors.New("...")     }     // ... }
  • 定义为包级变量,便于统一管理和比较
  • 不要在函数内反复调用 errors.New("xxx"),这会失去可比性
  • 错误字符串建议小写开头、无标点,符合 go 社区惯例

为什么不能用 errors.New 拼接动态内容

下面这种写法看似方便,实则破坏错误语义和可测试性:

// ❌ 错误示范:每次调用都新建不同 error 实例 return nil, errors.New("user ID " + strconv.Itoa(id) + " not found")

后果包括:

  • 无法用 if err == ErrNotFound 判断,只能用 strings.Contains(err.Error(), "...")
  • 丢失错误原始来源,调试时看不出是哪次调用生成的
  • 单元测试难写:不能预设相等错误,只能模糊匹配字符串

需要动态内容时,请改用:

return nil, fmt.Errorf("user ID %d not found", id)

errors.New 和 fmt.Errorf 在错误比较上的关键差异

errors.New 创建的错误支持指针相等(==),而 fmt.Errorf 默认返回新实例,不支持直接 ==

err1 := errors.New("EOF") err2 := errors.New("EOF") fmt.Println(err1 == err2) // true(Go 1.13+ 对相同字符串做了内部复用)  err3 := fmt.Errorf("EOF") err4 := fmt.Errorf("EOF") fmt.Println(err3 == err4) // false(每次都是新分配的对象)
  • 若需对 fmt.Errorf 做相等判断,应使用 errors.Is(err, target)(Go 1.13+)
  • errors.New 不支持嵌套错误(Unwrap()),也不参与错误链,这是它最硬的边界

真正要传递上下文又保持可判定性,得靠 fmt.Errorf("...: %w", originalErr) 配合 errors.Is / errors.As

text=ZqhQzanResources