使用errors.New可创建简单错误，适用于固定描述场景；如除零错误返回"errors.New(division by zero)"；需动态信息时用fmt.Errorf格式化输出；通过==比较判断自定义错误类型，如var ErrNotFound = errors.New("resource not found")用于精准错误处理。
在Go语言中，错误处理是程序设计的重要组成部分。errors包是Go标准库中最基础的错误处理工具，提供了创建和处理错误的基本能力。虽然功能简单，但在实际开发中非常实用。本文将介绍如何使用errors包创建错误，并结合常见场景给出实践建议。
使用 errors.New 创建简单错误
最直接的方式是使用 errors.New 函数创建一个带有错误信息的错误值。它适用于不需要额外上下文、仅需返回固定描述的场景。
package main
import (
"errors"
"fmt"
)
func divide(a, b int) (int, error) {
if b == 0 {
return 0, errors.New("division 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 创建的错误。这种写法简洁明了，适合大多数基础校验逻辑。
使用 fmt.Errorf 添加动态信息
当需要在错误中包含变量或运行时数据时，应使用 fmt.Errorf。它支持格式化字符串，能更清晰地表达错误上下文。
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
func openFile(name string) error {
if name == "" {
return fmt.Errorf("cannot open file: filename is empty")
}
// 模拟打开失败
return fmt.Errorf("failed to open file: %s", name)
}
例如，在文件操作中传入了非法名称，使用 fmt.Errorf 可以把具体的文件名输出到错误信息中，便于调试和日志追踪。
判断错误类型与比较
在接收错误后，常需要判断其具体类型或是否为某个已知错误，以便做出不同响应。可以使用 == 直接比较由 errors.New 返回的错误值。
var ErrNotFound = errors.New("resource not found")
func findUser(id int) (*User, error) {
if id <= 0 {
return nil, ErrNotFound
}
// 查找逻辑...
return &User{}, nil
}
// 调用时判断
user, err := findUser(-1)
if err == ErrNotFound {
fmt.Println("User does not exist")
}
这里定义了一个包级变量 ErrNotFound，在多个地方复用。调用方通过等值比较即可识别特定错误，这是Go中常见的错误分类方式。
注意事项与最佳实践
- 避免每次都用
errors.New("xxx")写相同字符串，应定义为变量以便复用和比较。 - 不要在错误消息中暴露敏感信息（如密码、路径细节），尤其在对外服务中。
- 错误信息应清晰、完整，说明“发生了什么”以及“可能的原因”。
- 对于复杂错误结构，可结合自定义错误类型实现
error接口，但简单场景优先使用errors.New或fmt.Errorf。
基本上就这些。Go的 errors 包虽小，但配合良好的习惯足以支撑大多数项目的错误处理需求。关键是保持一致性，让错误可读、可判断、可追溯。
