Golang errors错误创建与包装示例-Golang-PHP中文网

Golang errors错误创建与包装示例

P粉602998670

发布： 2025-09-24 15:47:01

原创

453人浏览过

Go通过error类型实现错误处理，使用errors.New和fmt.Errorf创建错误，支持用%w包装错误以保留调用链，可通过errors.Is和errors.As判断和解包错误，亦可定义结构体实现error接口以传递更多上下文信息。

golang errors错误创建与包装示例

在 Go 语言中，错误处理是程序设计的重要组成部分。Go 通过返回 error 类型来表示异常情况，而不是使用异常机制。本文将介绍如何创建和包装错误，提升代码的可读性和调试能力。

创建基本错误

最简单的错误创建方式是使用标准库中的 errors.New 或 fmt.Errorf。

errors.New 适用于静态错误消息：

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)
    }
    fmt.Println(result)
}

登录后复制

fmt.Errorf 用于格式化错误信息：

立即学习“go语言免费学习笔记（深入）”；

if b == 0 {
    return 0, fmt.Errorf("division failed: denominator is %v", b)
}

登录后复制

错误包装（Error Wrapping）

从 Go 1.13 开始，fmt.Errorf 支持使用 %w 动词来包装原始错误，保留错误链信息，便于排查问题根源。

func readFile(filename string) error {
    data, err := os.ReadFile(filename)
    if err != nil {
        return fmt.Errorf("failed to read file %s: %w", filename, err)
    }
    fmt.Println(string(data))
    return nil
}

登录后复制

这里使用 %w 将底层的 I/O 错误包装进新的错误中。调用方可以通过 errors.Unwrap 或 errors.Is、errors.As 来分析错误类型。

挖错网

一款支持文本、图片、视频纠错和AIGC检测的内容审核校对平台。

查看详情

判断和解包错误

使用 errors.Is 判断错误是否匹配某个值：

err := readFile("nonexistent.txt")
if errors.Is(err, os.ErrNotExist) {
    fmt.Println("File does not exist")
}

登录后复制

使用 errors.As 提取特定类型的错误以便访问其字段或方法：

var pathErr *os.PathError
if errors.As(err, &pathErr) {
    fmt.Printf("Path error occurred on path: %s\n", pathErr.Path)
}

登录后复制

自定义错误类型

对于更复杂的场景，可以定义自己的错误类型，实现 error 接口的 Error 方法。

type MyError struct {
    Code    int
    Message string
    Op      string
}

func (e *MyError) Error() string {
    return fmt.Sprintf("[%d] %s during %s", e.Code, e.Message, e.Op)
}

// 使用示例
func doSomething() error {
    return &MyError{Code: 400, Message: "invalid input", Op: "doSomething"}
}

登录后复制

这种结构化错误便于日志记录和程序逻辑判断。

基本上就这些。合理创建和包装错误能让调用者清楚知道发生了什么，也能保留足够的上下文用于调试。不复杂但容易忽略。

以上就是Golang errors错误创建与包装示例的详细内容，更多请关注php中文网其它相关文章！