Golang错误如何返回_Golang error基本语法与规范

Go 错误处理核心是显式返回 error 接口值，调用方必须主动检查；常用 errors.New、fmt.Errorf（推荐 %w 包装），支持 errors.Is/As 判断类型，避免暴露内部错误细节。

Go 语言中错误处理的核心是 显式返回 error 类型值，不依赖异常机制。函数通过多返回值（通常最后一个）返回 error，调用方必须主动检查，这是 Go 的设计哲学——“错误是值，不是例外”。

error 是接口，最常用的是 errors.New 和 fmt.Errorf

Go 内置的 error 是一个接口：
type error interface { Error() string }。
你只需实现这个方法，就能成为合法 error。但绝大多数场景用标准库就够了：

• errors.New("something went wrong") —— 简单字符串错误
• fmt.Errorf("failed to open %s: %w", filename, err) —— 带格式化 + 错误链（推荐用 %w 包装底层错误）
• 自定义 error 类型适合需要携带额外字段（如状态码、重试建议）时，例如实现 TimeoutError 并加 Timeout() bool 方法

必须检查 error，且通常优先处理

Go 不强制你写 if err != nil，但忽略它等于埋雷。惯用写法是“失败即返回”，让正常逻辑缩进最小化：

• ✅ 推荐：if err != nil { return err } 或 return nil, err
• ❌ 避免：if err == nil { /* 正常逻辑一大段 */ } —— 嵌套深，易漏错
• 注意：defer 中的函数不会自动获取主函数的 err 变量，需显式传参或闭包捕获

区分错误类型：用 errors.Is 和 errors.As

不要用 == 或 strings.Contains(err.Error(), "...") 判断错误种类，它们脆弱且无法穿透错误链：

• errors.Is(err, fs.ErrNotExist) —— 判断是否为某类底层错误（支持 %w 链）
• var e *os.PathError; if errors.As(err, &e) { ... } —— 尝试提取具体错误类型，用于访问其字段
• 自定义 error 实现 Is() 或 As() 方法可增强语义（比如网络超时 error 主动声明 Is(timeoutErr)）

不暴露内部错误细节给上层或用户

底层 error（如数据库驱动错误、系统调用错误）通常含敏感路径或内部结构，不应直接返回给 API 调用方或日志公开：

• 对外返回新 error：fmt.Errorf("failed to save user: %w", dbErr)，再用 errors.Unwrap 或日志中间件记录原始错误
• HTTP handler 中，用 http.Error(w, "Internal server error", http.StatusInternalServerError)，而非把 dbErr.Error() 直接吐给前端
• 调试时可用 fmt.Printf("%+v", err) 查看完整错误链和栈帧（需用 github.com/pkg/errors 或 Go 1.13+ 原生支持）

基本上就这些。Golang 的 error 处理不复杂但容易忽略边界，关键是养成“每次调用后立刻问一句：这里可能出错吗？”的习惯。