Go 函数错误处理与零值返回：优化复杂结构体返回策略

func ThisIsMyComplexFunc() (s ComplexStruct, err error) {
    // s 和 err 在函数开始时已经被声明并初始化为它们的零值。
    // 对于 ComplexStruct，其零值是所有字段都设置为各自零值的结构体实例。
    // 对于 error 类型，其零值是 nil。

    // 假设在函数执行初期遇到一个错误
    if someConditionCausesError {
        err = fmt.Errorf("an early error occurred: %w", specificError)
        return // 裸返回，s 将以其零值返回，err 将以我们设置的值返回
    }

    // ... 正常业务逻辑，构建 s ...
    // s = ComplexStruct{ /* populate fields */ }

    // 如果没有错误，直接返回
    return
}

package main

import (
    "errors"
    "fmt"
)

// ComplexStruct 代表一个复杂的结构体
type ComplexStruct struct {
    ID      string
    Value   int
    Details map[string]string
    IsValid bool
}

// ThisIsMyComplexFunc 演示了如何使用命名返回值处理早期错误
func ThisIsMyComplexFunc(input string) (s ComplexStruct, err error) {
    // s 和 err 已经被声明并初始化为零值：
    // s = ComplexStruct{ID:"", Value:0, Details:nil, IsValid:false}
    // err = nil

    if input == "" {
        err = errors.New("input cannot be empty")
        return // 此时 s 将以其零值返回
    }

    if input == "invalid" {
        err = errors.New("invalid input string")
        return // 此时 s 仍以其零值返回
    }

    // 模拟正常业务逻辑，构建 ComplexStruct
    s.ID = "data-" + input
    s.Value = len(input) * 10
    s.Details = map[string]string{"source": "example"}
    s.IsValid = true

    // 正常返回，s 和 err 的当前值会被返回
    return
}

func main() {
    // 案例 1: 正常执行
    cs1, err1 := ThisIsMyComplexFunc("valid_data")
    if err1 != nil {
        fmt.Printf("Error 1: %v\n", err1)
    } else {
        fmt.Printf("Result 1: %+v\n", cs1)
    }
    // 预期输出: Result 1: {ID:data-valid_data Value:100 Details:map[source:example] IsValid:true}

    fmt.Println("---")

    // 案例 2: 早期错误 - 空输入
    cs2, err2 := ThisIsMyComplexFunc("")
    if err2 != nil {
        fmt.Printf("Error 2: %v\n", err2)
    } else {
        fmt.Printf("Result 2: %+v\n", cs2)
    }
    // 预期输出: Error 2: input cannot be empty
    // 此时 cs2 的值将是 ComplexStruct 的零值：{ID: Value:0 Details:map[] IsValid:false}
    fmt.Printf("Returned struct for error 2: %+v\n", cs2)

    fmt.Println("---")

    // 案例 3: 早期错误 - 无效输入
    cs3, err3 := ThisIsMyComplexFunc("invalid")
    if err3 != nil {
        fmt.Printf("Error 3: %v\n", err3)
    } else {
        fmt.Printf("Result 3: %+v\n", cs3)
    }
    // 预期输出: Error 3: invalid input string
    fmt.Printf("Returned struct for error 3: %+v\n", cs3)
}