首页 > Golang > Go教程

errors.New与fmt.Errorf区别详解

时间：2025-08-29 11:15:45 269浏览收藏

最近发现不少小伙伴都对Golang很感兴趣，所以今天继续给大家介绍Golang相关的知识，本文《自定义错误创建方法：errors.New与fmt.Errorf详解》主要内容涉及到等等知识点，希望能帮到你！当然如果阅读本文时存在不同想法，可以在评论中表达，但是请勿使用过激的措辞~

errors.New用于创建固定错误信息，适合静态错误；2. fmt.Errorf支持格式化动态生成错误消息，更灵活；3. 使用%w可包装错误并保留原始错误，便于后续判断类型。

如何创建自定义错误 errors.New和fmt.Errorf用法

在 Go 语言中，处理错误是程序设计的重要部分。除了使用标准库提供的错误外，我们经常需要创建自定义错误来更准确地描述问题。Go 提供了 errors.New 和 fmt.Errorf 两种常用方式来创建错误。下面详细介绍它们的用法和适用场景。

errors.New：创建简单的静态错误

当你只需要一个固定的错误消息时，errors.New 是最简单直接的方式。它返回一个实现了 error 接口的错误值。

示例：

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)
    } else {
        fmt.Println("Result:", result)
    }
}

输出：

Error: cannot divide by zero

这种写法适合错误信息固定、不需要动态参数的情况。

fmt.Errorf：格式化创建错误

当你需要根据上下文动态生成错误消息时，应使用 fmt.Errorf。它的用法类似于 fmt.Printf，支持格式化占位符。

示例：

func readFile(filename string) error {
    if filename == "" {
        return fmt.Errorf("invalid filename: %q is not allowed", filename)
    }
    // 模拟读取文件失败
    return fmt.Errorf("failed to open file: %s", filename)
}

func main() {
    err := readFile("")
    if err != nil {
        fmt.Println("Error:", err)
    }
}

输出：

Error: invalid filename: "" is not allowed

fmt.Errorf 更灵活，适合需要拼接变量或提供上下文信息的错误。

包装错误并保留原始错误信息

从 Go 1.13 开始，fmt.Errorf 支持通过 %w 动词来包装错误，这样可以保留原始错误，便于后续使用 errors.Is 或 errors.As 判断错误类型。

示例：

import (
    "errors"
    "fmt"
)

var ErrNotFound = errors.New("item not found")

func findItem(id int) (string, error) {
    if id

使用 %w 可以构建错误链，让调用方能追溯根本原因。

基本上就这些。简单错误用 errors.New，带变量的用 fmt.Errorf，需要错误链时记得用 %w 包装原始错误。不复杂但容易忽略细节。

今天关于《errors.New与fmt.Errorf区别详解》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！