17370845950

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")
)

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

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 == ErrNotFou

  

  nd 判断，只能用 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。