0

0

c++如何使用protobuf c++数据序列化教程【实例】

裘德小鎮的故事

裘德小鎮的故事

发布时间:2026-01-02 15:07:26

|

101人浏览过

|

来源于php中文网

原创

C++中使用Protobuf序列化需三步:编写.proto文件定义结构,用protoc生成C++代码,再在程序中创建、序列化(SerializeToOstream)和反序列化(ParseFromIstream)对象,全程需检查布尔返回值确保成功。

c++如何使用protobuf c++数据序列化教程【实例】

在 C++ 中使用 Protocol Buffers(Protobuf)做数据序列化,核心是三步:写 .proto 文件定义结构 → 用 protoc 编译生成 C++ 类 → 在代码中创建、序列化、反序列化对象。下面以一个简单但完整的实例带你走通全流程。

1. 定义消息格式(.proto 文件)

新建 person.proto,描述一个“人”的基本信息:

syntax = "proto3";
package tutorial;

message Person {
  string name = 1;
  int32 id = 2;
  string email = 3;
  repeated string phone = 4;
}

说明:
syntax = "proto3" 表示使用 Protobuf v3 语法;
package 避免命名冲突,生成的 C++ 类会放在 tutorial::Person 命名空间;
repeated 表示可变长字段(对应 std::vector<:string>);
• 数字(1/2/3/4)是字段唯一标识符,不能随意改动,影响二进制兼容性。

2. 生成 C++ 代码

确保已安装 protoc(Protobuf 编译器),执行:

protoc --cpp_out=. person.proto

会生成两个文件:
person.pb.h —— 包含类声明和内联方法;
person.pb.cc —— 包含实现,需参与编译。

注意:
• 若提示找不到 google/protobuf 头文件,请确认已安装 protobuf 开发包(如 Ubuntu 下 sudo apt install libprotobuf-dev protobuf-compiler);
• 编译时需链接 -lprotobuf

3. 编写 C++ 序列化与反序列化代码

新建 main.cpp

立即学习C++免费学习笔记(深入)”;

Amazon Nova
Amazon Nova

亚马逊云科技(AWS)推出的一系列生成式AI基础模型

下载
#include 
#include 
#include 
#include "person.pb.h"

int main() {
  // 创建并填充 Person 对象
  tutorial::Person person;
  person.set_name("张三");
  person.set_id(12345);
  person.set_email("zhangsan@example.com");
  person.add_phone("138-0013-8000");
  person.add_phone("0755-1234567");

  // 序列化为二进制(保存到文件)
  std::ofstream output("person.dat", std::ios::binary);
  if (!person.SerializeToOstream(&output)) {
    std::cerr << "序列化失败\n";
    return -1;
  }
  output.close();

  // 反序列化(从文件读取)
  tutorial::Person restored;
  std::ifstream input("person.dat", std::ios::binary);
  if (!restored.ParseFromIstream(&input)) {
    std::cerr << "反序列化失败\n";
    return -1;
  }
  input.close();

  // 打印验证
  std::cout << "Name: " << restored.name() << "\n";
  std::cout << "ID: " << restored.id() << "\n";
  std::cout << "Email: " << restored.email() << "\n";
  for (const auto& phone : restored.phone()) {
    std::cout << "Phone: " << phone << "\n";
  }

  return 0;
}

关键点:
• 所有字段访问器(set_xxx()xxx()add_xxx())均由 Protobuf 自动生成;
SerializeToOstream()ParseFromIstream() 是最常用、最安全的 I/O 方式;
• 若需内存中序列化(如网络传输),可用 SerializeToString()SerializeToArray()
• 所有 Protobuf 操作默认不抛异常,务必检查返回值(bool)判断成败。

4. 编译与运行

假设使用 g++,命令如下:

g++ -std=c++11 main.cpp person.pb.cc -lprotobuf -o person_demo

然后运行:

./person_demo

输出应显示张三的信息,且生成 person.dat 二进制文件(不可读,但体积小、解析快)。

不复杂但容易忽略

相关文章

c++速学教程(入门到精通)
c++速学教程(入门到精通)

c++怎么学习?c++怎么入门?c++在哪学?c++怎么学才快?不用担心,这里为大家提供了c++速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

312

2023.08.02

mysql标识符无效错误怎么解决
mysql标识符无效错误怎么解决

mysql标识符无效错误的解决办法:1、检查标识符是否被其他表或数据库使用;2、检查标识符是否包含特殊字符;3、使用引号包裹标识符;4、使用反引号包裹标识符;5、检查MySQL的配置文件等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

179

2023.12.04

Python标识符有哪些
Python标识符有哪些

Python标识符有变量标识符、函数标识符、类标识符、模块标识符、下划线开头的标识符、双下划线开头、双下划线结尾的标识符、整型标识符、浮点型标识符等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

272

2024.02.23

java标识符合集
java标识符合集

本专题整合了java标识符相关内容,想了解更多详细内容,请阅读下面的文章。

251

2025.06.11

c++标识符介绍
c++标识符介绍

本专题整合了c++标识符相关内容,阅读专题下面的文章了解更多详细内容。

121

2025.08.07

mysql标识符无效错误怎么解决
mysql标识符无效错误怎么解决

mysql标识符无效错误的解决办法:1、检查标识符是否被其他表或数据库使用;2、检查标识符是否包含特殊字符;3、使用引号包裹标识符;4、使用反引号包裹标识符;5、检查MySQL的配置文件等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

179

2023.12.04

Python标识符有哪些
Python标识符有哪些

Python标识符有变量标识符、函数标识符、类标识符、模块标识符、下划线开头的标识符、双下划线开头、双下划线结尾的标识符、整型标识符、浮点型标识符等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

272

2024.02.23

java标识符合集
java标识符合集

本专题整合了java标识符相关内容,想了解更多详细内容,请阅读下面的文章。

251

2025.06.11

php源码安装教程大全
php源码安装教程大全

本专题整合了php源码安装教程,阅读专题下面的文章了解更多详细内容。

74

2025.12.31

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Go 教程
Go 教程

共32课时 | 3.2万人学习

Go语言实战之 GraphQL
Go语言实战之 GraphQL

共10课时 | 0.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号