VO结构体必须加JSON标签，否则json.Marshal输出字段全为小写或空值；需显式声明如json:"user_name,omitempty"，嵌套结构体各层字段也须加标签，不可复用Model，应独立定义并严格隔离包路径与职责。
VO结构体该不该加JSON标签
必须加，否则json.Marshal输出字段全为小写或空值。Go默认导出字段首字母大写，但不加json标签时，序列化仍可能因字段名映射失败而丢数据——尤其当VO字段名与数据库列名不一致时。
常见错误现象：json.Marshal返回{"name":"","age":0}，但实际字段已赋值；或字段名变成name而非期望的user_name。
- 统一用
json:"user_name,omitempty"：显式控制键名，omitempty跳过零值字段（如空字符串、0、nil切片） - 避免混用
json和db标签在同一字段上造成混淆，VO只面向HTTP响应，不参与ORM映射 - 如果VO嵌套其他结构体，确保所有层级字段都带
json标签，否则深层字段无法透出
VO要不要复用Model结构体字段
不要直接复用。Model通常含敏感字段（如PasswordHash、DeletedAt）、内部状态（如CreatedAt时间戳精度太高）、或未脱敏数据（如完整手机号），直接返回会引发安全与耦合问题。
使用场景：用户详情接口需返回id、nickname、avatar_url，但Model里还有email（需权限校验）、last_login_ip（不应暴露）。
立即学习“go语言免费学习笔记（深入）”；
- VO必须手动定义字段，哪怕和Model同名同类型，也单独声明——这是明确契约的开始
- 可用
mapstructure或copier库做字段拷贝，但禁止用json.Marshal + json.Unmarshal中转，性能差且易丢字段 - 若多个接口共用部分VO字段（如分页元信息），抽成独立结构体，例如
PaginationVO，再被各VO内嵌
如何处理VO中的关联数据（如用户+角色列表）
VO里不放原始Model切片，而应转为精简结构。例如角色字段不能直接塞[]RoleModel，因为RoleModel可能含created_by、updated_at等无关字段。
典型错误：前端拿到roles: [{id:1,name:"admin",desc:"...",created_at:"2024-01-01T00:00:00Z"}]，但desc字段未国际化、created_at格式也不符合前端约定。
- 定义
RoleSummaryVO，只含ID、Name、Code等必要字段，并打上对应json标签 - 在组装VO时，用
for range逐个转换，别依赖反射自动映射——可控、可加日志、可提前过滤空值 - 若关联数据可能为空（如用户未分配角色），VO字段声明为
[]RoleSummaryVO而非*[]RoleSummaryVO，避免前端多一层判空逻辑
VO命名和包组织怎么避免混乱
VO结构体必须放在vo/子目录下，文件名与结构体名一致（如vo/user_vo.go含UserVO），且不对外暴露Model路径。这是防止业务代码意外导入VO包并误当Model用的关键隔离。
容易踩的坑：把VO放在model/下，起名UserResp，结果单元测试里直接拿它查数据库；或不同接口用同一VO却悄悄加了字段，导致调用方解析失败。
- VO结构体名以
VO结尾（如OrderDetailVO），不叫Response或DTO，语义清晰 - HTTP handler层负责初始化VO，service层只返回Model或领域对象，绝不返回VO——职责边界必须卡死
- 如果VO字段需要运行时计算（如
IsVip bool），在handler组装VO时计算并赋值，不在VO里写方法或逻辑
