使用 errors.New 可创建简洁的自定义错误，适用于仅需字符串描述的场景。如除零错误返回 "cannot divide by zero"，或结合 fmt.Sprintf 动态生成如 "invalid age: -5 seems unrealistic" 的提示。它适合无需附加字段的简单错误处理，相比结构化 error 类型更轻量，但应确保消息清晰且不泄露敏感信息。
在 Go 语言中，错误处理是程序设计的重要部分。Go 没有异常机制，而是通过返回 error 类型来表示错误状态。使用 errors.New 是创建自定义错误最简单直接的方式。它适用于不需要附加信息、仅需描述错误场景的简单情况。
使用 errors.New 创建基础自定义错误
errors.New 函数接收一个字符串，返回一个实现了 error 接口的类型。你可以在函数中直接使用它来表示特定的错误条件。
package main
import (
"errors"
"fmt"
)
func divide(a, b float64) (float64, error) {
if b == 0 {
return 0, errors.New("cannot divide by zero")
}
return a / b, nil
}
func main() {
result, err := divide(10, 0)
if err != nil {
fmt.Println("Error:", err)
} else {
fmt.Println("Result:", result)
}
}
这段代码中，当除数为 0 时，函数返回由 errors.New 构造的错误。main 函数通过判断 err 是否为 nil 来决定是否输出错误信息。
封装更具体的错误信息
虽然 errors.New 很简单，但在某些场景下你可能需要根据输入动态生成错误消息。这时可以结合 fmt.Sprintf 动态构造错误描述。
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
package main
import (
"errors"
"fmt"
)
func validateAge(age int) error {
if age < 0 {
return errors.New(fmt.Sprintf("invalid age: %d is negative", age))
}
if age > 150 {
return errors.New(fmt.Sprintf("invalid age: %d seems unrealistic", age))
}
return nil
}
func main() {
err := validateAge(-5)
if err != nil {
fmt.Println("Validation failed:", err)
}
}
这种方式让你能将运行时数据嵌入错误信息中，便于调试和日志记录。
何时使用 errors.New 而不是自定义 error 类型
errors.New 适合用于：
- 错误只包含一条静态或格式化后的消息
- 不需要额外的方法或字段（如错误码、时间戳等）
- 快速原型开发或简单项目中的错误处理
如果你需要携带结构化信息（比如错误级别、唯一标识符），建议定义实现 error 接口的结构体。但大多数情况下，errors.New 已经足够清晰有效。
基本上就这些。用好 errors.New 可以让代码保持简洁，同时提供有意义的错误提示。不复杂但容易忽略的是：错误信息应尽量清晰、可读，并避免暴露敏感数据。
