Golang自定义错误创建方法详解

在Golang实战开发的过程中，我们经常会遇到一些这样那样的问题，然后要卡好半天，等问题解决了才发现原来一些细节知识点还是没有掌握好。今天golang学习网就整理分享《如何在Golang中使用errors.New创建自定义错误_Golang 自定义错误实践》，聊聊，希望可以帮助到正在努力赚钱的你。

使用 errors.New 可创建简洁的自定义错误，适用于仅需字符串描述的场景。如除零错误返回 "cannot divide by zero"，或结合 fmt.Sprintf 动态生成如 "invalid age: -5 seems unrealistic" 的提示。它适合无需附加字段的简单错误处理，相比结构化 error 类型更轻量，但应确保消息清晰且不泄露敏感信息。

在 Go 语言中，错误处理是程序设计的重要部分。Go 没有异常机制，而是通过返回 error 类型来表示错误状态。使用 errors.New 是创建自定义错误最简单直接的方式。它适用于不需要附加信息、仅需描述错误场景的简单情况。

使用 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)
    }
}

这段代码中，当除数为 0 时，函数返回由 errors.New 构造的错误。main 函数通过判断 err 是否为 nil 来决定是否输出错误信息。

封装更具体的错误信息

虽然 errors.New 很简单，但在某些场景下你可能需要根据输入动态生成错误消息。这时可以结合 fmt.Sprintf 动态构造错误描述。

package main

import (
    "errors"
    "fmt"
)

func validateAge(age int) error {
    if age  150 {
        return errors.New(fmt.Sprintf("invalid age: %d seems unrealistic", age))
    }
    return nil
}

func main() {
    err := validateAge(-5)
    if err != nil {
        fmt.Println("Validation failed:", err)
    }
}

这种方式让你能将运行时数据嵌入错误信息中，便于调试和日志记录。

何时使用 errors.New 而不是自定义 error 类型

errors.New 适合用于：

• 错误只包含一条静态或格式化后的消息
• 不需要额外的方法或字段（如错误码、时间戳等）
• 快速原型开发或简单项目中的错误处理

如果你需要携带结构化信息（比如错误级别、唯一标识符），建议定义实现 error 接口的结构体。但大多数情况下，errors.New 已经足够清晰有效。

基本上就这些。用好 errors.New 可以让代码保持简洁，同时提供有意义的错误提示。不复杂但容易忽略的是：错误信息应尽量清晰、可读，并避免暴露敏感数据。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Golang自定义错误创建方法详解》文章吧，也可关注golang学习网公众号了解相关技术文章。