旧版protobuf API已废弃，必须迁移到v1.26+新接口：改用protoreflect.Message替代proto.Message，prototext.MarshalOptions替代proto.MarshalTextString，删除XXX_方法并用ProtoReflect()访问元信息，统一升级go.mod、protoc及插件版本确保生成代码与runtime兼容。
proto.Message 接口已不可用，必须改用 protoreflect.Message
Go 的 google.golang.org/protobuf v1.28+ 彻底移除了旧版 proto.Message 接口定义。如果你还在用 proto.MarshalTextString(msg) 或依赖 proto.Message 类型约束，代码会直接报错：undefined: proto.Message。
- 旧写法（v1.25 及之前）：
func handle(m proto.Message) { ... } - 新写法（v1.26+）：
func handle(m protoreflect.Message) { ... }，需导入google.golang.org/protobuf/reflect/protoreflect -
proto.MarshalTextString已废弃，改用prototext.MarshalOptions{}.Format(m)（导入google.golang.org/protobuf/encoding/prototext） - 若函数签名无法立刻改，可用适配器临时桥接：
m.ProtoReflect()返回protoreflect.Message，但注意 nil 安全检查
XXX_ 方法全部失效，Descriptor 访问路径统一收口
生成的 pb.go 文件里，所有 XXX_* 方法（如 XXX_MessageName、XXX_DiscardUnknown、XXX_Unmarshal）在新版中被彻底删除。调用它们会导致编译错误：msg.XXX_MessageName undefined。
- 获取消息全名：旧写法
msg.XXX_MessageName()→ 新写法msg.ProtoReflect().Descriptor().FullName() - 判断是否为 nil 消息：旧写法
msg == nil || msg.XXX_IsNil()→ 新写法msg == nil || msg.ProtoReflect().IsValid() == false - 反序列化：旧写法
proto.Unmarshal(data, msg)仍可用（兼容层），但推荐迁移到proto.UnmarshalOptions{}.Unmarshal(data, msg)以控制行为 - 别试图保留旧方法签名——生成器不再输出 XXX_，强行保留会导致构建失败
扩展字段操作必须转为类型安全访问
proto.GetExtension 和 proto.SetExtension 在 v1.27+ 中已被标记为 deprecated，v1.30+ 将彻底移除。继续使用会触发 warning，且无法通过 -gcflags="-e" 严格模式编译。
- 旧写法：
proto.GetExtension(msg, myExtField, &val) - 新写法：
val := myExtField.Get(msg.ProtoReflect())（myExtField是protoreflect.ExtensionType类型） - 必须提前注册扩展字段类型（通常由 protoc-gen-go 自动生成并 init 注册），否则
Get返回零值且无提示 - 如果项目还混用
github.com/golang/protobuf（老库），必须完全替换为google.golang.org/protobuf，二者不兼容
go.mod 与 protoc 插件版本必须严格对齐
环境升级不是只改代码——go.mod 里的 protobuf 版本、本地 protoc 编译器、以及 protoc-gen-go 插件三者版本不一致，会导致生成代码含残留 XXX_ 方法或缺失 ProtoReflect()，引发运行时 panic 或编译失败。
立即学习“go语言免费学习笔记（深入）”；
- 执行：
go get google.golang.org/protobuf@latest和go install google.golang.org/protobuf/cmd/protoc-gen-go@latest - 检查 protoc 版本：
protoc --version应 ≥ 3.21.12（否则生成代码不兼容新 runtime） - 重新生成所有 .proto：
protoc --go_out=. --go_opt=paths=source_relative *.proto，不要复用旧生成文件 - 删掉
vendor/或go.sum中残留的github.com/golang/protobuf条目，它和新库冲突
