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 动词来包装错误,保留原始错误链:php版微信js-sdk支付接口类php版微信js-sdk支付接口类下载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 intMsg 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 的错误处理虽简单,但坚持清晰返回、合理包装、必要时自定义类型,能让程序更易维护和调试。
