Go语言错误处理技巧与实战

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

使用 fmt.Errorf 结合 %w 动词可格式化并封装错误，保留原始上下文，支持 errors.Is 和 errors.As 判断，如 return fmt.Errorf("读取文件失败: %w", err)，并在多层调用中添加有意义的上下文信息，提升错误定位能力。

在Golang中，对错误信息进行格式化通常通过 fmt.Errorf 函数实现，它可以将变量插入到错误消息中，便于调试和日志记录。Go 1.13 引入了错误封装（error wrapping）机制，使得我们不仅能格式化错误信息，还能保留原始错误的上下文。

使用 fmt.Errorf 格式化错误信息

最常见的方式是使用 fmt.Errorf 结合动词如 %v、%s、%d 等来构造带上下文的错误信息。

示例：

if err != nil {
    return fmt.Errorf("处理用户数据失败: %w", err)
}

添加上下文信息

在调用链的每一层添加有意义的上下文，有助于定位问题。

例如：

func readFile(filename string) error {
    data, err := os.ReadFile(filename)
    if err != nil {
        return fmt.Errorf("无法读取文件 %s: %w", filename, err)
    }
    // 处理数据...
    if len(data) == 0 {
        return fmt.Errorf("文件 %s 内容为空", filename)
    }
    return nil
}

这样，最终的错误信息会包含文件名和底层 I/O 错误。

提取和判断封装的错误

使用标准库中的 errors.Is 和 errors.As 可以安全地判断或提取原始错误。

示例：

err := readFile("config.json")
if err != nil {
    if errors.Is(err, os.ErrNotExist) {
        log.Println("文件不存在")
    } else if pe, ok := err.(*os.PathError); ok {
        log.Printf("路径错误: %s", pe.Path)
    } else {
        log.Printf("其他错误: %v", err)
    }
}

自定义错误类型（可选）

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

例如：

type MyError struct {
    Code    int
    Message string
    Err     error
}

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

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

这样既能格式化输出，也能通过 Unwrap 与 errors 包配合使用。

基本上就这些。合理使用 fmt.Errorf 和 %w，结合上下文信息，能让错误处理更清晰可靠。

到这里，我们也就讲完了《Go语言错误处理技巧与实战》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！