C#怎么实现Protobuf序列化 C# Protobuf-net使用方法-C#.Net教程-PHP中文网

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

煙雲

发布： 2025-12-19 11:01:32

原创

522人浏览过

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

c#怎么实现protobuf序列化 c# protobuf-net使用方法

在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<t>(stream)</t>

示例：

Tellers AI

Tellers是一款自动视频编辑工具，可以将文本、文章或故事转换为视频。

136

查看详情

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<Person>(ms2);

登录后复制