repeated字段需在.proto中用repeated关键字定义，生成go切片；赋值前须初始化或用append；数字类型默认packed编码省空间；json默认omit_empty，空切片不输出。
proto 里怎么写 repeated 字段
repeated 就是 protobuf 的数组/列表语法，不是 Go 特有概念，得先在 .proto 文件里正确定义，Go 生成代码才会对应出切片类型。
常见错误是写成 array、list 或漏掉 repeated 关键字，导致生成的 Go 结构体字段是单个值而不是 []T。
-
repeated string names = 1;→ 生成Names []string -
repeated User users = 2;→ 生成Users []*User（注意是指针切片） - 不能写
repeated optional string name = 1;——repeated和optional冲突，直接报错 - 字段编号必须唯一且非零，别和其它字段重复
Go 里怎么往 repeated 字段赋值
生成的 repeated 字段是可变切片，但底层是 nil-safe 的：空值是 nil，不是空切片 []T{}。直接 append 可能 panic，得先初始化。
典型错误现象：panic: assignment to entry in nil map 或 append on nil slice —— 其实是误以为字段已初始化，实际是 nil。
- 安全写法：
msg.Users = append(msg.Users, &User{Name: "Alice"})——append能处理nil切片 - 显式初始化：
msg.Users = []*User{}，再用append或下标赋值 - 别直接写
msg.Users[0] = ...，除非你确认长度 > 0 - 如果反复增删，注意切片底层数组可能被复用，敏感数据需手动清零
repeated 字段序列化后 size 怎么算
protobuf 对 repeated 字段默认用“打包编码”（packed encoding），尤其对数字类型（int32、bool 等），会把多个值压进一个 tag-length-value 块里，比每个元素单独编码省空间。
但这个优化只对 primitive 类型自动开启；对 message 类型（比如 repeated User）默认不 packed，体积更大。
- 强制 packed：
repeated int32 ids = 1 [packed=true]; - packed=false 是默认行为，但仅对非 primitive 类型生效；加了也没用
- Go 侧无需额外处理，
proto.Marshal自动按 proto 定义编码 - 如果用 Wireshark 或
protoc --decode_raw看二进制，packed 字段的 length 值会明显小
repeated 字段在 JSON 映射时要注意什么
Go 的 google.golang.org/protobuf/encoding/protojson 默认把 repeated 字段转成 JSON 数组，但有几个边界情况容易翻车。
常见错误现象：空 repeated 字段在 JSON 里消失（变成 omit），前端收不到 "users": [] 而是根本没这个 key。
- 默认 behavior 是
omit_empty——nil或空切片都不输出 - 要强制输出空数组，初始化字段：
msg.Users = []*User{}，或用protojson.MarshalOptions{UseProtoNames: true, EmitUnpopulated: true} - 如果 proto 里字段带
json_name选项，比如repeated string tags = 3 [json_name = "tag_list"];，Go 生成代码会自动映射，不用手写 struct tag - 注意：JSON 中
null不会被反序列化为nilslice，而是直接失败 —— protobuf JSON 不支持null表示缺失字段
repeated 字段看着简单，但 nil 切片、packed 编码、JSON 输出策略这三块最容易在上线后突然暴露问题，尤其是跨语言联调时，一边认为“空就是没传”，另一边坚持“没传等于空”。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
