当前位置：首页 > 文章列表 > Golang > Go教程 > Golang错误创建与包装实例解析

Golang错误创建与包装实例解析

2025-12-27 20:41:58 0浏览收藏

Golang不知道大家是否熟悉？今天我将给大家介绍《Golang错误创建与包装实例详解》，这篇文章主要会讲到等等知识点，如果你在看完本篇文章后，有更好的建议或者发现哪里有问题，希望大家都能积极评论指出，谢谢！希望我们能一起加油进步！

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 用于格式化错误信息：

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 来分析错误类型。

判断和解包错误

使用 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的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~