分离模型结构体与REST API表示：结构体双向转换最优方案咨询

我有一个用于数据库及其他内部业务逻辑的User结构体：

type User struct {
    ID       int64  `json:"id"`
    Email    string `json:"email"`
    Password []byte `json:"password"`
    LastIP   string `json:"lastIP"`
}

该结构体包含Password和LastIP属性，我不希望通过REST API暴露这些属性，且不想使用json:"-"标签。因此引入了仅用于REST API的UserRepresentation结构体：

type UserRepresentation struct {
    ID       int64  `json:"id"`
    Email    string `json:"email"`
}

请问实现User与UserRepresentation双向转换的最佳方式是什么？是否存在非手动的转换方法？

一、手动转换（小结构体场景首选） #

手动编写转换函数是最直接、性能最优的方案，无外部依赖，逻辑清晰，还能灵活处理特殊字段逻辑：

1. User → UserRepresentation #

func (u *User) ToRepresentation() UserRepresentation {
    return UserRepresentation{
        ID:    u.ID,
        Email: u.Email,
    }
}

2. UserRepresentation → User #

如果需要从API DTO反向构建内部User，可以这样写：

func (ur *UserRepresentation) ToUser() User {
    return User{
        ID:    ur.ID,
        Email: ur.Email,
        // 敏感字段根据业务需求设置零值或默认逻辑
        Password: []byte{},
        LastIP:   "",
    }
}

这种方式适合字段不多的场景，维护成本低，出问题也好排查。

二、非手动转换（大结构体场景适用） #

如果结构体字段数量多，手动编写转换代码太繁琐，可以用Go生态里的结构体拷贝工具：

1. 使用jinzhu/copier #

这个库支持按字段名自动拷贝，也能通过标签忽略指定字段：

import "github.com/jinzhu/copier"

// User转UserRepresentation
var ur UserRepresentation
copier.Copy(&ur, &user)

// UserRepresentation转User
var u User
copier.Copy(&u, &ur)
// 注意：拷贝后敏感字段会是对应类型的零值，需根据业务补充逻辑

2. 使用mitchellh/mapstructure #

先将结构体转成map，再映射到目标结构体，适合复杂字段映射场景：

import "github.com/mitchellh/mapstructure"

// User转UserRepresentation
var ur UserRepresentation
mapstructure.Decode(user, &ur)

// UserRepresentation转User
var u User
mapstructure.Decode(ur, &u)

注意事项 #

• 工具库虽能节省代码量，但性能略逊于手动转换；如果字段名不一致或有特殊类型转换，需要额外配置标签或自定义逻辑。
• 反向转换时，内部User的敏感字段（如Password）绝不能从API DTO直接获取，需严格按业务规则处理，避免安全风险。

内容的提问来源于stack exchange，提问作者Vincent