在Golang的标准库中，errors包提供了errors.New函数，这是创建自定义错误最基础也最常用的方式，能够满足大部分简单场景下的错误定义需求。
errors.New的基本用法
errors.New的函数签名非常简单，接收一个字符串参数作为错误信息，返回一个error类型的实例。我们可以直接调用它来创建错误，也可以将创建的错误赋值给变量重复使用。
下面是一个最基础的使用示例：
package main
import (
"errors"
"fmt"
)
func main() {
// 直接创建错误并打印
err := errors.New("这是一个自定义错误")
fmt.Println(err.Error()) // 输出：这是一个自定义错误
// 将错误作为返回值返回
result, err := divide(10, 0)
if err != nil {
fmt.Println("计算失败：", err)
return
}
fmt.Println("计算结果：", result)
}
// 除法函数，除数为0时返回自定义错误
func divide(a, b int) (int, error) {
if b == 0 {
return 0, errors.New("除数不能为0")
}
return a / b, nil
}
errors.New创建错误的特点
使用errors.New创建的错误属于*errors.errorString类型，这个类型是标准库内部定义的，实现了error接口的Error()方法。这类错误有以下特点：
- 错误信息是固定的字符串，创建后无法修改
- 错误实例每次调用errors.New都会生成新的对象，即使错误信息相同，两个错误实例也不相等
- 适合定义简单的、不需要携带额外上下文信息的错误
我们可以通过下面的代码验证错误实例的比较情况：
package main
import (
"errors"
"fmt"
)
func main() {
err1 := errors.New("相同错误")
err2 := errors.New("相同错误")
// 两个错误实例不相等，因为errors.New每次返回新的对象
fmt.Println(err1 == err2) // 输出：false
// 同一个错误变量赋值后比较
err3 := err1
fmt.Println(err1 == err3) // 输出：true
}
errors.New与自定义错误类型的对比
当我们需要错误携带更多上下文信息，或者需要根据错误类型做不同的处理逻辑时，仅用errors.New就不够了，这时候可以自定义实现error接口的类型。下面是对比示例：
package main
import (
"errors"
"fmt"
)
// 自定义错误类型，携带错误码和错误信息
type MyError struct {
Code int
Message string
}
// 实现error接口的Error方法
func (e *MyError) Error() string {
return fmt.Sprintf("错误码：%d，错误信息：%s", e.Code, e.Message)
}
func main() {
// 使用errors.New创建的错误
err1 := errors.New("简单错误")
fmt.Println(err1.Error())
// 使用自定义错误类型创建的错误
err2 := &MyError{Code: 1001, Message: "参数校验失败"}
fmt.Println(err2.Error())
// 可以判断自定义错误类型，做针对性处理
if e, ok := err2.(*MyError); ok {
fmt.Println("捕获到自定义错误，错误码为：", e.Code)
}
}
errors.New的最佳实践
在实际开发中，使用errors.New创建自定义错误时可以遵循以下实践：
- 对于全局复用的简单错误，建议定义为包级变量，避免重复创建实例
- 错误信息要清晰明确，能够直接反映错误产生的原因
- 如果错误需要携带额外信息或者需要类型判断，优先使用自定义错误类型，简单无额外信息的错误用errors.New即可
下面是全局错误变量的定义示例：
package user
import "errors"
// 定义全局复用的错误变量
var (
ErrUserNotFound = errors.New("用户不存在")
ErrInvalidParam = errors.New("参数无效")
)
func GetUser(id int) (string, error) {
if id <= 0 {
return "", ErrInvalidParam
}
// 模拟用户查询逻辑
if id != 1 {
return "", ErrUserNotFound
}
return "测试用户", nil
}
常见问题解答
errors.New创建的错误可以被包装吗
在Golang 1.13之后，标准库提供了errors.Is和errors.As函数，以及fmt.Errorf的%w动词用于错误包装。errors.New创建的错误可以作为底层错误被包装，例如：
package main
import (
"errors"
"fmt"
)
func main() {
baseErr := errors.New("底层错误")
// 包装错误，添加上层上下文
wrapErr := fmt.Errorf("上层错误：%w", baseErr)
// 使用errors.Is判断底层错误
if errors.Is(wrapErr, baseErr) {
fmt.Println("捕获到对应的底层错误")
}
}
errors.New和fmt.Errorf有什么区别
fmt.Errorf可以格式化错误信息，而errors.New只能接收固定字符串。如果只是需要简单的错误字符串，两者都可以使用，但是如果需要动态拼接错误信息，fmt.Errorf会更方便。不过fmt.Errorf默认返回的错误不支持%w包装，只有使用%w动词时才会返回可被包装的错误。
Golangerrors_New自定义错误error接口修改时间：2026-07-09 17:21:32