Go函数应返回error类型表示错误,使用fmt.Errorf包装并保留错误链,自定义错误类型增强语义,避免用nil或空字符串混淆错误信号,确保调用方能正确处理。

在 Go 语言中,错误处理是函数设计的重要部分。Go 没有异常机制,而是通过函数返回值显式传递错误,这要求开发者在编写函数时主动考虑并返回可能的错误信息。正确地在函数返回中传递错误,不仅能提升代码健壮性,还能让调用方清晰掌握执行状态。
函数返回错误的基本模式
Go 函数通常将 error 类型作为最后一个返回值。标准库和大多数项目都遵循这一约定。
例如:
func divide(a, b float64) (float64, error) {if b == 0 {
return 0, fmt.Errorf("cannot divide by zero")
}
return a / b, nil
}
调用该函数时,应检查 error 是否为 nil:
立即学习“go语言免费学习笔记(深入)”;
result, err := divide(10, 2)if err != nil {
log.Fatal(err)
}
fmt.Println(result)
这种模式强制调用者处理错误,避免忽略潜在问题。
封装并传递底层错误
当函数调用其他可能出错的操作(如文件读取、网络请求)时,不应静默吞掉错误,而应合理封装并返回。
建议使用 fmt.Errorf 结合 %w 动词来包装错误,保留原始错误链:
data, err := os.ReadFile("config.json")if err != nil {
return fmt.Errorf("failed to read config file: %w", err)
}
这样既添加了上下文,又可通过 errors.Is 或 errors.As 进行错误类型判断。
自定义错误类型增强语义
对于复杂场景,可定义结构体实现 error 接口,提供更丰富的错误信息。
示例:
type ParseError struct {Line int
Msg string
}
func (e *ParseError) Error() string {
return fmt.Sprintf("parse error at line %d: %s", e.Line, e.Msg)
}
函数可返回具体类型,便于调用方做精确判断:
if err := parse(); err != nil {if perr, ok := err.(*ParseError); ok {
fmt.Printf("Fix line: %d\n", perr.Line)
}
}
避免 nil 和空字符串错误混用
不要返回 "" 或 0 作为错误信号,Go 的惯用法是利用 error 类型本身表达失败状态。即使没有具体错误信息,也应使用 errors.New 或 nil 明确表示。
正确做法:
if condition {return "", errors.New("invalid input")
}
return "success", nil
不推荐:
if condition {return "", "" // 含义模糊
} 基本上就这些。Go 的错误处理虽简单,但坚持清晰返回、合理包装、必要时自定义类型,能让程序更易维护和调试。










