为何protoc从proto文件生成Python代码时未生成预期类？

你看到的生成结果和旧教程结构不符，是protobuf 3.20及以上版本的默认设计，不是生成错误：

• 3.19及更早版本的Python代码生成器采用静态生成逻辑，会把每个消息对应的类、元类、字段处理逻辑、序列化方法的样板代码全量写入_pb2.py文件，官方旧教程里展示的带显式元类的示例就是这个版本的产物。
• 3.20之后的版本默认启用upb快速生成模式，生成的文件仅存储proto编译后的二进制描述符，所有消息类构造、元类绑定、方法注入逻辑，都在模块导入时通过_builder模块的两个构建方法动态完成，因此你在静态生成的文件里看不到显式的元类定义。

这个改动不影响代码正常调用，所有对外API和旧版本完全兼容，你可以直接按照教程中的写法导入类、赋值字段、执行序列化/反序列化，不需要调整业务代码。新的生成模式能大幅缩小生成文件体积，提升模块导入速度。

如果确实需要生成和旧教程一致的、显式包含元类定义的代码，可以在执行protoc命令时追加--py_opt=legacy参数，强制使用旧版生成逻辑：

protoc -I="." --python_out="." --py_opt=legacy test.proto

执行后生成的文件就会是旧版的静态类定义结构。

内容的提问来源于stack exchange，提问作者Tekuu59