Protobuf在C#中需先生成.cs类才能使用API，否则报TypeLoadException；主流生成方式为protoc命令行（--csharp_out）或MSBuild集成Grpc.Tools自动编译.proto文件。
Protobuf 在 C# 中不是开箱即用的，必须用 Google.Protobuf 库 + 生成的 .cs 类型文件才能工作；直接调用 SerializeToString() 或 ParseFrom() 前，你得先有 .proto 文件和对应的 C# 类。
怎么生成 C# 类（protoc + Grpc.Tools）
不生成类就调用 Protobuf API，会立刻报 TypeLoadException 或找不到 MyMessage.Descriptor。生成方式有两种主流路径：
- 用
protoc命令行工具：安装protoc后执行protoc --csharp_out=. my.proto，依赖Google.ProtobufNuGet 包 - 更推荐用 MSBuild 集成：在 .csproj 中添加
<PackageReference Include="Grpc.Tools" Version="2.62.0" PrivateAssets="all" />，再把.proto文件设为<Protobuf Include="my.proto" Link="my.proto" />，编译时自动产出MyMessage.cs - 注意
package名称会变成 C# 的命名空间，syntax = "proto3";是必须声明，否则生成器可能静默失败
SerializeToByteArray() 和 ParseFrom<T>() 怎么用才安全
Protobuf 的序列化/反序列化是无反射、零分配（除 byte[] 外）的，但容易踩几个隐性坑：
- 字段未赋值时，
int32默认为0，string默认为null（proto3），但ParseFrom()不校验字段是否存在 —— 缺失字段不会抛异常，只会用默认值填充 - 务必用
TryParseFrom()替代ParseFrom()做网络输入校验，否则损坏的二进制流会直接抛InvalidProtocolBufferException -
SerializeToByteArray()返回的是紧凑二进制，不能直接当字符串打印或日志输出；若需可读调试，改用ToString()（文本格式）或JsonFormatter.Default.Format(msg)
性能关键：避免重复创建 Serializer<T> 或缓存 ByteString
Protobuf 的 C# 实现本身已高度优化，但高频场景下仍有明显瓶颈点：
-
ByteString.CopyFrom(byte[])是深拷贝，如果反复包装同一段 buffer，建议复用ByteString实例，或直接用WriteTo(Stream)避免中间 byte[] - 不要手动 new
Serializer<MyMsg>()—— 它内部已静态缓存了序列化逻辑，直接调用实例方法即可 - 对小消息（SerializeToMemoryStream() 比
SerializeToByteArray()多一次内存复制，优先选后者
真正麻烦的从来不是“怎么写那几行代码”，而是 proto 文件定义变更后没同步更新生成类、或跨服务版本混用不兼容的 schema —— 这类问题在线上表现为静默数据丢失，而不是报错。
