当前位置：首页 > 文章列表 > Golang > Go教程 > Golang错误定义与公共错误声明方法

Golang错误定义与公共错误声明方法

2026-02-11 17:48:44 0浏览收藏

本篇文章给大家分享《Golang错误变量定义与公共错误声明模式》，覆盖了Golang的常见基础知识，其实一个语言的全部知识点一篇文章是不可能说完的，但希望通过这些问题，让读者对自己的掌握程度有一定的认识(B 数)，从而弥补自己的不足，更好的掌握它。

Go中通过var声明公共错误变量，如ErrNotFound，使用fmt.Errorf配合%w包装错误以保留原错误链，支持errors.Is和errors.As判断，自定义错误类型可携带状态码等信息，遵循Err开头、小写描述、复用变量等最佳实践，提升代码可读性和错误处理一致性。

Golang错误变量如何定义_Golang公共错误声明模式

在Go语言中，错误处理是通过返回值显式处理的，因此定义清晰、可复用的错误变量非常重要。为了提升代码可读性和一致性，Go社区形成了一套公共错误声明的模式。

使用 var 声明公共错误

最常见的方式是在包级别使用 var 块声明错误变量，配合 errors.New 初始化。这些错误通常表示函数可能返回的特定失败情况。

例如：

var (
    ErrNotFound          = errors.New("resource not found")
    ErrInvalidArgument   = errors.New("invalid argument provided")
    ErrUnauthorized      = errors.New("unauthorized access")
    ErrTimeout           = errors.New("operation timed out")
)

这种方式让错误在整个包甚至其他包中都能被引用，调用方可以使用 errors.Is 进行判断。

使用 fmt.Errorf 配合 %w 实现包装错误

当需要附加上下文但又保留原始错误类型时，应使用 fmt.Errorf 并配合 %w 动词进行错误包装。

示例：

if err := readFile(); err != nil {
    return fmt.Errorf("failed to read config: %w", err)
}

这样既保留了底层错误链，又能提供更丰富的上下文信息，同时支持 errors.Is 和 errors.As 的匹配。

自定义错误类型以携带更多信息

对于需要携带额外数据（如状态码、时间戳）的场景，可以定义实现 error 接口的结构体。

例如：

type AppError struct {
    Code    int
    Message string
    Err     error
}

func (e *AppError) Error() string {
    return fmt.Sprintf("[%d] %s: %v", e.Code, e.Message, e.Err)
}

func (e *AppError) Unwrap() error {
    return e.Err
}

这种模式适合构建分层应用中的错误体系，便于中间件统一处理和日志记录。