0

0

Python如何操作Protobuf?protobuf序列化

爱谁谁

爱谁谁

发布时间:2025-08-16 22:38:01

|

905人浏览过

|

来源于php中文网

原创

protobuf文件设计应预留字段、使用oneof和repeated关键字、添加版本注释以增强扩展性;处理兼容性问题需保持字段编号不变、避免删除字段、合理使用optional和enum的allow_alias;protobuf相比json具有体积小、解析快的优势,但可读性差,因此更适合高性能要求的内部服务通信和数据存储场景,而json更适合配置文件和对外api等需高可读性的场景。

Python如何操作Protobuf?protobuf序列化

Protobuf (Protocol Buffers) 是一种轻便高效的结构化数据存储格式,特别适合做数据交换协议和数据存储。Python 操作 Protobuf 核心在于定义

.proto
文件,然后使用 Protobuf 编译器生成 Python 代码,最后在 Python 代码中使用生成的类进行序列化和反序列化。

protobuf序列化

首先,你需要安装 Protobuf 编译器

protoc
和 Python 的 Protobuf 库。

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

# 安装 protobuf 编译器 (例如在 Ubuntu 上)
sudo apt-get update
sudo apt-get install protobuf-compiler

# 安装 Python protobuf 库
pip install protobuf

假设我们有一个简单的

.proto
文件,描述一个 Person 对象:

// person.proto
syntax = "proto3";

package example;

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

接下来,使用

protoc
编译器生成 Python 代码:

protoc --python_out=. person.proto

这会在当前目录下生成

person_pb2.py
文件,其中包含了
Person
类的定义。

现在,可以在 Python 代码中使用这个类进行序列化和反序列化了:

晓象AI资讯阅读神器
晓象AI资讯阅读神器

晓象-AI时代的资讯阅读神器

下载
import person_pb2

# 创建一个 Person 对象
person = person_pb2.Person()
person.name = "John Doe"
person.id = 123
person.email = "john.doe@example.com"

# 序列化
serialized_data = person.SerializeToString()
print(f"Serialized data: {serialized_data}")

# 反序列化
new_person = person_pb2.Person()
new_person.ParseFromString(serialized_data)

print(f"Name: {new_person.name}, ID: {new_person.id}, Email: {new_person.email}")

这就是一个基本的操作流程。

Protobuf 文件应该如何设计才能更好地适应未来的需求变化?

设计 Protobuf 文件时,考虑未来的扩展性至关重要。 一个好的策略是预留一些字段,即使当前用不到。例如,可以添加一些编号较高的字段,并附上注释说明“Reserved for future use”。 另外,使用

oneof
关键字可以处理互斥字段的情况,避免不必要的字段同时存在。 同时,尽量使用
repeated
关键字来表示列表,即使当前列表只有一个元素,也方便未来扩展为多个元素。 版本控制也很重要,可以考虑在
.proto
文件中加入版本号注释,方便追踪变更历史。 例如,可以这样写:
// Version: 1.0

如何处理 Protobuf 序列化中的兼容性问题?

Protobuf 的设计目标之一就是保持向后兼容性。 当你修改

.proto
文件时,只要遵循一些规则,就可以保证新旧代码可以互相解析。 最重要的是,不要修改已有的字段编号,也不要删除已有的字段。 如果需要修改字段类型,要确保新的类型可以兼容旧的类型。 例如,将
int32
改为
int64
是安全的,但反过来则可能导致数据丢失。 可以使用
optional
关键字来添加新的字段,这样旧的代码在解析新的消息时,会忽略这些未知的字段。 另外,可以使用
enum
类型来表示枚举值,并添加
allow_alias
选项,允许不同的枚举值使用相同的编号。 例如:

enum Status {
  option allow_alias = true;
  OK = 0;
  PENDING = 1;
  RUNNING = 1; // RUNNING 和 PENDING 具有相同的编号
}

Protobuf 与 JSON 相比,有哪些优缺点?在什么场景下更适合使用 Protobuf?

Protobuf 和 JSON 都是常用的数据序列化格式,但它们各有优缺点。 Protobuf 的优点是体积小、解析速度快,因为它采用二进制格式存储数据,并且使用了高效的编码算法。 JSON 的优点是可读性好,易于调试,因为它是文本格式,可以直接用文本编辑器打开查看。 另外,JSON 的生态系统非常完善,很多编程语言都提供了内置的 JSON 解析库。 Protobuf 更适合对性能要求较高的场景,例如网络传输、数据存储等。 JSON 更适合对可读性要求较高的场景,例如配置文件、API 接口等。 一个常见的场景是,内部服务之间使用 Protobuf 进行数据交换,而对外提供的 API 使用 JSON 格式。 这样既可以保证内部服务的性能,又可以方便外部开发者使用。

相关专题

更多
python开发工具
python开发工具

php中文网为大家提供各种python开发工具,好的开发工具,可帮助开发者攻克编程学习中的基础障碍,理解每一行源代码在程序执行时在计算机中的过程。php中文网还为大家带来python相关课程以及相关文章等内容,供大家免费下载使用。

764

2023.06.15

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

639

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

764

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

619

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

1285

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

549

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

579

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

709

2023.08.11

PS使用蒙版相关教程
PS使用蒙版相关教程

本专题整合了ps使用蒙版相关教程,阅读专题下面的文章了解更多详细内容。

23

2026.01.19

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 5.6万人学习

Django 教程
Django 教程

共28课时 | 3.3万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.2万人学习

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

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