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

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 拼接动态内容
下面这种写法看似方便,实则破坏错误语义和可测试性:
动态WEB网站中的PHP和MySQL详细反映实际程序的需求,仔细地探讨外部数据的验证(例如信用卡卡号的格式)、用户登录以及如何使用模板建立网页的标准外观。动态WEB网站中的PHP和MySQL的内容不仅仅是这些。书中还提到如何串联JavaScript与PHP让用户操作时更快、更方便。还有正确处理用户输入错误的方法,让网站看起来更专业。另外还引入大量来自PEAR外挂函数库的强大功能,对常用的、强大的包
// ❌ 错误示范:每次调用都新建不同 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。









