Go 如何将错误作为值来处理？

Question

Go 如何将错误作为值来处理？

Accepted Answer

Go **没有异常**用于普通错误。相反，错误是从函数返回的**值**（通常作为最后一个返回值），调用者**显式检查**它们。这使错误处理可见、有意为之、不可能被无声忽视——这是 Go 的定义性哲学。

## error 类型和核心模式

```go
// `error` is a built-in interface: anything with an Error() string method
type error interface {
    Error() string
}

// functions return (result, error) — error is nil on success
func divide(a, b float64) (float64, error) {
    if b == 0 {
        return 0, errors.New("division by zero")   // create an error
    }
    return a / b, nil    // nil = no error
}

// the ubiquitous calling pattern
result, err := divide(10, 0)
if err != nil {              // CHECK the error explicitly
    fmt.Println("error:", err)
    return
}
fmt.Println(result)
```

`if err != nil { ... }` 检查在 Go 中随处可见——每个可能失败的操作都后跟显式的错误检查。这种冗长性是有意的：错误总是可见的，并在调用处进行处理。

## 创建错误

```go
errors.New("something failed")                       // simple error
fmt.Errorf("failed to process %s: %w", name, err)    // formatted, with WRAPPING (%w)
```

## 包装和检查错误

```go
// %w WRAPS an underlying error, preserving the chain
if err != nil {
    return fmt.Errorf("reading config: %w", err)   // adds context, keeps original
}

// unwrap and inspect with errors.Is / errors.As
if errors.Is(err, os.ErrNotExist) { ... }          // check for a specific error
var pathErr *os.PathError
if errors.As(err, &pathErr) { ... }                 // extract a specific error type
```

包装（`%w`）在错误向上传播时添加上下文，而 `errors.Is`/`errors.As` 让你检查或提取特定的底层错误——这是处理错误链的现代方式。

## 自定义错误类型

```go
type ValidationError struct {
    Field string
}
func (e *ValidationError) Error() string {           // implement the error interface
    return "invalid field: " + e.Field
}
return &ValidationError{Field: "email"}
```

## errors 与 panic 对比

```text
error (values) → EXPECTED, recoverable conditions (file missing, bad input) — the norm
panic          → UNEXPECTED, programmer errors / unrecoverable (nil deref, out of bounds)
→ Use errors for normal failure handling; reserve panic for truly exceptional cases.
```

## 为什么这很重要

Go 的错误即值的方法是其最具定义性和最具争议的特征之一，与基于异常的语言从根本上不同。

通过返回错误作为调用者必须显式检查的值（`if err != nil`），Go 使错误处理**可见、本地化，且不可能被意外忽视**——你确切地看到每个错误在哪里处理，以冗长性为代价提高了可靠性。

理解这一哲学、`(result, error)` 模式、错误包装（`%w`）与 `errors.Is`/`errors.As` 用于添加上下文和检查链、自定义错误类型，以及错误（普通、可恢复）与 panic（异常、程序员错误）之间的区别是绝对必需的——它渗透到每个 Go 程序中，代表了来自基于异常的语言的开发者的核心思维转变。

这也是最常见的 Go 面试话题之一。