proto3中int32、string等基本类型默认生成值类型（如int32、string），无法区分“未设置”与“设为0/空”，需改用optional关键字生成指针类型（如*int32）以支持nil判空。
proto3 下 int32、string 等基本类型直接映射为 Go 值类型
proto3 默认不区分“未设置”和“零值”，所以 int32 id = 1 生成的是 Id int32 字段，不是 *int32。这意味着：赋值为 0 和字段根本没传，在反序列化后表现完全一致；proto.Marshal 总会把该字段写入二进制流（哪怕值是 0）。如果你需要显式区分是否传了字段，必须改用 optional int32 id = 1 —— 这样生成的才是 Id *int32，且 nil 表示未设置。
message 类型字段默认生成指针，嵌套消息必须手动初始化
只要 proto 定义里是 message 类型（比如 User profile = 2），生成的 Go 字段就是 Profile *Profile。这和基本类型完全不同：proto.Marshal 遇到 nil 的 message 字段会直接报错 proto: required field not set（即使语法上没标 required，proto3 中所有非-optional message 字段都隐式视为 required）。常见错误包括：
- 声明了
req := &User{}但没给req.Profile赋值，直接调proto.Marshal(req)就 panic - 误以为
req.GetProfile()会自动初始化，其实它只做安全取值（返回nil或已存在的指针） - 在 oneof 中漏设分支，比如定义了
oneof payload { string text = 1; bytes data = 2; }，但没设任何字段，Marshal 也会失败
repeated 和 map 字段不能直接赋值，要用 MutableXxx 方法
repeated string tags = 3 生成的是 Tags []string 字段，但直接写 req.Tags = append(req.Tags, "v1") 是错的——因为生成代码里该字段可能为 nil，而 append(nil, ...) 虽然合法，但后续 Marshal 可能因底层切片未正确绑定状态而出问题。更严重的是 map 类型：GetLabels() 返回的是深拷贝，修改它完全不影响原消息。正确做法是：
- 对切片：先调
req.MutableTags()拿到可修改切片引用，再append - 对 map：必须用
req.MutableLabels()，它内部会检查并初始化nilmap - 不要反复调
GetXxx()，高频场景下每次调用都分配新 slice/map，有性能开销
go_package 选项决定包路径，路径错会导致 import 失败或类型不匹配
生成的 .pb.go 文件包名不来自 package xxx，而是由 option go_package = "github.com/your/repo/pb" 决定。如果漏写或写错，会出现两种典型问题：
- Go 编译报
undefined: pb.User：实际是因为生成的文件放在了默认包（如main）下，而你 import 的是另一个路径 - 运行时报
proto: not a message type：两个同名结构体来自不同包路径，Go 视为不同类型，proto.Marshal拒绝处理 - 使用
--go_opt=paths=source_relative后，protoc会按go_package的最后一段建目录，比如pb就建./pb/user.pb.go，别手动挪文件
= 1）一旦发布就不能改，否则旧客户端发来的二进制流会被新服务端解析成错误字段；optional 字段虽灵活，但 Dart/Python 等语言需对应启用 optional 支持，否则仍当普通字段处理。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
