如何让函数参数为泛型结构体？Go语言重复代码优化求助

嘿，我完全懂你的痛点——每次新增一个Command结构体就要写几乎一模一样的解析代码，简直是重复劳动！你之前尝试泛型却得到[]map[string]interface{}，大概率是泛型的类型声明或者使用方式出了问题，我来给你一步步修复。

首先，先还原一下你原来的重复代码大概是什么样的（应该和下面差不多）：

// 解析UserCommand的函数
func ParseUserCommands(data []byte) ([]UserCommand, error) {
    var commands []UserCommand
    if err := json.Unmarshal(data, &commands); err != nil {
        return nil, err
    }
    // 可能还有一些通用的校验、预处理逻辑
    return commands, nil
}

// 解析ProductCommand的函数，除了类型几乎完全复制
func ParseProductCommands(data []byte) ([]ProductCommand, error) {
    var commands []ProductCommand
    if err := json.Unmarshal(data, &commands); err != nil {
        return nil, err
    }
    // 同样的通用逻辑
    return commands, nil
}

正确的泛型实现方案 #

我们可以用Go 1.18+的泛型特性，写一个通用的解析函数，让它支持任意可被JSON反序列化的结构体类型：

// 泛型解析函数，T代表任意符合要求的命令结构体类型
func ParseCommands[T any](data []byte) ([]T, error) {
    // 声明目标类型的切片，这是关键！之前你可能没正确声明这个切片类型
    var commands []T
    
    // 反序列化到目标切片指针
    if err := json.Unmarshal(data, &commands); err != nil {
        return nil, fmt.Errorf("failed to unmarshal commands: %w", err)
    }
    
    // 这里可以加入所有命令都需要的通用逻辑，比如字段校验
    // 举个例子：如果你的Command都有Validate方法，可以在这里统一调用
    // for _, cmd := range commands {
    //     if err := cmd.Validate(); err != nil {
    //         return nil, fmt.Errorf("invalid command: %w", err)
    //     }
    // }
    
    return commands, nil
}

如何使用这个泛型函数 #

调用的时候只需要指定具体的结构体类型即可，完全不需要重复写解析逻辑：

// 解析UserCommand
userCommands, err := ParseCommands[UserCommand](jsonData)
if err != nil {
    // 处理错误，比如log.Fatal(err)
}

// 解析ProductCommand
productCommands, err := ParseCommands[ProductCommand](jsonData)
if err != nil {
    // 处理错误
}

为什么你之前的方案会返回[]map[string]interface{}？ #

大概率是你在泛型函数里没有明确声明[]T类型的变量，而是错误地用了[]interface{}或者没有指定类型参数，导致Go的类型推断自动把目标类型解析成了map[string]interface{}（JSON默认的动态类型）。只要像上面这样明确声明var commands []T，并把指针传给json.Unmarshal，就能正确得到目标结构体的切片了。

进阶：给命令添加约束（可选） #

如果你的所有Command结构体都有共同的方法（比如Validate()），可以定义一个约束接口，让泛型函数更严谨：

// 定义Command约束，要求类型必须实现Validate方法
type Command interface {
    Validate() error
}

// 更新泛型函数，约束T必须实现Command接口
func ParseCommands[T Command](data []byte) ([]T, error) {
    var commands []T
    if err := json.Unmarshal(data, &commands); err != nil {
        return nil, fmt.Errorf("failed to unmarshal commands: %w", err)
    }
    
    // 统一执行每个命令的校验逻辑
    for _, cmd := range commands {
        if err := cmd.Validate(); err != nil {
            return nil, fmt.Errorf("command validation failed: %w", err)
        }
    }
    
    return commands, nil
}

这样一来，所有不符合Command约束的类型都无法传入这个函数，避免了误用。

内容的提问来源于stack exchange，提问作者Trần Kim Dự