首页 > Golang > Go教程

Golang错误处理：error类型与自定义错误解析

时间：2026-01-14 19:25:35 445浏览收藏

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

Go错误处理显式依赖error接口，通过errors.New、fmt.Errorf（支持%w包装）和自定义结构体实现；用==、errors.Is、errors.As判断错误，支持错误链与类型提取。

如何使用Golang实现错误处理_使用error类型和自定义错误

Go 语言的错误处理强调显式判断和传递，不依赖异常机制。核心是使用内置的 error 接口类型，并可通过 errors.New、fmt.Errorf 或自定义结构体实现更丰富的错误信息和行为。

理解 error 接口

error 是一个内建接口，定义如下：

type error interface {
Error() string
}

任何实现了 Error() string 方法的类型，都可作为错误值使用。标准库中大多数错误都是该接口的实例。

使用标准错误构造函数

快速创建简单错误：

errors.New("something went wrong") —— 返回一个带固定消息的不可变错误
fmt.Errorf("failed to open %s: %w", filename, err) —— 支持格式化，%w 可包装底层错误（用于错误链）

示例：

if n < 0 {
return 0, errors.New("factorial not defined for negative numbers")
}

定义自定义错误类型

当需要携带额外字段（如状态码、时间、原始值）或提供特定方法时，定义结构体并实现 Error() 方法：

type ValidationError struct {
  Field string
  Value interface{}
  Msg string
}

func (e *ValidationError) Error() string {
  return fmt.Sprintf("validation error on %s: %v — %s", e.Field, e.Value, e.Msg)
}

使用时：

return nil, &ValidationError{Field: "email", Value: input, Msg: "invalid format"}

判断和处理错误

Go 鼓励直接比较或类型断言来识别错误：

用 == 判断是否为预定义错误（如 io.EOF）
用 errors.Is(err, target) 判断是否为同一错误或其包装链中的错误
用 errors.As(err, &target) 提取底层自定义错误实例

例如：

var ve *ValidationError
if errors.As(err, &ve) {
log.Printf("Validation failed for %s: %s", ve.Field, ve.Msg)
}

错误包装与展开

用 %w 在 fmt.Errorf 中包装错误，形成错误链；用 errors.Unwrap 或 errors.Is/As 向下查找原因：

err := fmt.Errorf("reading config: %w", io.ErrUnexpectedEOF)
fmt.Println(errors.Is(err, io.ErrUnexpectedEOF)) // true

这支持语义化错误分类，也便于调试时追溯根本原因。

到这里，我们也就讲完了《Golang错误处理：error类型与自定义错误解析》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！

前往漫画官网入口并下载 ➜