C#怎么实现Protobuf序列化 C# Protobuf-net使用方法

推荐使用protobuf-net实现C# Protobuf序列化，它无需protoc编译器，通过[ProtoContract]和[ProtoMember(n)]特性标记类与成员，支持高效二进制序列化/反序列化，并提供版本兼容、性能优化等进阶功能。

在C#中使用Protobuf序列化，推荐用 protobuf-net（由Marc Gravell维护），它不依赖官方protoc编译器，支持直接通过特性（Attribute）标记类，轻量、高效、易集成。

1. 安装 protobuf-net 包

在项目中通过NuGet安装：

Visual Studio：工具 → NuGet包管理器 → 管理解决方案的NuGet包 → 搜索并安装 protobuf-net
命令行（.NET CLI）：dotnet add package protobuf-net

2. 定义可序列化的类

用 [ProtoContract] 标记类，用 [ProtoMember(n)] 标记字段或属性，序号 n 必须唯一且建议从1开始（兼容Protocol Buffers规范）：

[ProtoContract]
public class Person
{
    [ProtoMember(1)]
    public int Id { get; set; }

    [ProtoMember(2)]
    public string Name { get; set; }

    [ProtoMember(3)]
    public DateTime BirthDate { get; set; }
}

⚠ 注意：字段/属性必须是public，或配合[ProtoInclude]、[ProtoIgnore]等做更细控制；不支持自动属性无getter/setter（如public string Name { get; }会报错）。

3. 序列化与反序列化操作

使用 Serializer 静态类完成二进制读写：

序列化（对象 → byte[]）：Serializer.Serialize(stream, obj)
反序列化（byte[] → 对象）：Serializer.Deserialize(stream)

示例：

var person = new Person { Id = 123, Name = "张三", BirthDate = new DateTime(1990, 5, 1) };

// 序列化到内存流
using var ms = new MemoryStream();
Serializer.Serialize(ms, person);
byte[] data = ms.ToArray();

// 反序列化回来
using var ms2 = new MemoryStream(data);
Person restored = Serializer.Deserialize(ms2);

4. 进阶提示（实用但易忽略）

• 默认不支持Dictionary和多维数组：需手动处理或改用 List> + 自定义转换。

• 版本兼容靠字段序号，不是字段名：新增字段加新序号、旧字段不要删或改序号，可设 [ProtoMember(4, IsRequired = false, Default = 0)] 提高健壮性。

• 性能优化建议：对高频类型可预生成序列化器（RuntimeTypeModel.Default.Add(typeof(Person)).CompileInPlace();），避免运行时反射开销。

基本上就这些。不需要写 .proto 文件，也不用跑 protoc，适合快速上手和中小规模数据交换场景。

# 工具 # ai # stream # c# # .net # red # String # 多维数组 # public # Attribute # 对象 # default # typeof # visual studio # 性能优化 # 序列化 # 进阶 # 不支持 # 多维 # 推荐使用 # 自定义 # 管理器 # 不需 # 报错 # 它不

返回目录在线咨询

上一篇：使用云指h5建站时，怎样选择合适的模板来提升网站专业度？
下一篇：Spring 中 @Service 和 @Resource 注解的区别

您的项目需求