在 Go 语言中，当函数声明为返回 (T, error) 类型时，若 error 非 nil，其余返回值应视为未定义；通常按零值（如 ""、0、nil）返回，且调用方不得依赖其内容——这是 Go 社区广泛遵循的约定。
在 go 语言中，当函数声明为返回 `(t, error)` 类型时，若 `error` 非 nil，其余返回值应视为未定义；通常按零值（如 `""`、`0`、`nil`）返回，且调用方不得依赖其内容——这是 go 社区广泛遵循的约定。
Go 的多返回值机制是其核心设计特色之一，尤其在错误处理场景中，func() (T, error) 模式已成为事实标准。但初学者常困惑：当发生错误时，为何还要“凑”一个看似无意义的 T 值（如空字符串 ""）？答案在于契约一致性与调用安全。
✅ 正确做法：返回零值，明确语义
你的 GetBasicAuth 函数写法完全正确：
func GetBasicAuth(w http.ResponseWriter, r *http.Request) (string, error) {
secret, _, ok := r.BasicAuth()
if !ok {
return "", errors.New("missing or invalid Authorization header") // ✅ 返回零值 "" + 具体错误
}
return secret, nil
}- "" 是 string 类型的零值，语义清晰：“无有效凭据”，而非“未知凭据”；
- 调用方只需检查 err != nil 即可决定跳过 secret 的使用，无需额外判断 secret == ""；
- 这符合 Go 标准库的统一约定（如 os.Open, strconv.Atoi 等），保障了 API 的可预测性。
⚠️ 关键原则：error != nil ⇒ 其他返回值不可信
除非函数文档明确声明例外行为（例如 io.Reader.Read），否则必须遵守：
当 err != nil 时，所有其他返回值均视为未定义（unspecified），调用方不得读取、比较或使用它们。
反例（❌ 错误）：
secret, err := GetBasicAuth(w, r)
if err != nil {
log.Printf("Auth failed, got secret: %q", secret) // 危险！secret 可能是任意零值或残留值
}✅ 正确用法始终是：
secret, err := GetBasicAuth(w, r)
if err != nil {
http.Error(w, "Unauthorized", http.StatusUnauthorized)
return
}
// 此时 secret 才保证有效且非零值
processSecret(secret)? 补充说明：何时可返回“有意义”的非零值？
极少数场景下，函数可在出错时仍提供部分有效数据（如解析器返回已成功解析的字段数）。此时必须在函数文档中显式说明，例如：
// ParseHeader returns the number of parsed headers and an error.
// Even if err != nil, n is always valid and indicates how many headers were successfully processed.
func ParseHeader(data []byte) (n int, err error) { ... }但这类设计需谨慎，避免增加调用方认知负担。对绝大多数 I/O、验证、转换类函数，坚持“零值 + error”范式是最清晰、最安全的选择。
总结：Go 的多返回值不是语法糖，而是契约设计。返回零值不是妥协，而是向调用方传递明确信号——“本次操作失败，结果无效”。坚守这一约定，代码将更健壮、更易维护，也更符合 Go 的哲学。
