oneof 是协议缓冲区 Protobuf 里面的关键字，它的作用是在同一个消息结构体里面定义一组互斥字段，同一时刻这组字段里面只能有一个字段被赋值生效，不能多个字段同时填充，连接使用本质就是在编写 proto 文件定义 oneof，然后通过代码生成器编译，再在业务代码里面调用对应的 set 方法绑定其中一个分支字段，完成 oneof 的关联赋值。之所以要用 oneof，是因为很多业务场景需要多类型可选参数，比如同一条消息可能是文本也可能是图片还可能是视频，如果普通字段全部独立定义，会造成字段冗余，还容易出现多个字段同时赋值的逻辑错误，oneof 可以强制互斥约束，节省序列化空间，让消息结构更加规范。
定义 proto 文件
打开后缀为 proto 的源文件，在 message 消息内部，写入 oneof 关键字，后面自定义名称，大括号内部写入所有互斥的字段，每个字段都要标注类型 编号 字段名，编号在整个 message 里面不能重复，oneof 内部字段编号也不能和 message 外层普通字段编号冲突。示例写法就是在 message DemoMessage 里面，写 oneof content，然后依次添加 string text int32 num bytes data 这类字段。
编译生成代码
保存 proto 文件之后，调用 protoc 编译器，加上对应的语言插件，比如 java go cpp python 插件，执行编译命令，把 proto 定义转换成目标编程语言的类或者结构体。编译成功之后，生成的代码会自动为 oneof 生成对应的分支枚举，还有每一个字段专属的 setter getter 方法，同时会生成获取当前 oneof 是哪一个分支的查询方法。
业务代码连接赋值
在业务代码里面实例化生成的消息对象，调用 oneof 对应的 set 方法，选择其中一个分支进行赋值，赋值完成之后，oneof 就会绑定这个字段，如果后续再次调用另一个分支的 set 方法，之前已经赋值的分支会自动清空，保证始终只有一个字段处于激活状态。也可以调用查询方法，读取当前 oneof 命中的是哪一个选项，用来做分支判断处理。
注意事项
oneof 里面不能包含 required 修饰的字段，oneof 内部的字段不能使用 group 类型，oneof 字段编号要规划好，后续迭代新增分支的时候不能复用旧编号，oneof 不能嵌套在 repeated 里面，序列化的时候只会保存当前激活的那一个分支，未激活分支不会写入字节流。
最终总结，oneof 连接不是网络连接，而是 proto 消息内部互斥分支的绑定，先在 proto 文件声明 oneof 分组，编译生成代码，再通过 set 方法选择分支赋值，运行时保持互斥，适合多类型可选消息的业务建模。
【常见问题】
问题 1 oneof 怎么连之后能不能同时设置两个分支
回答 1 oneof 怎么连完成赋值之后，不可以同时设置两个分支，oneof 本身设计就是互斥，一旦调用新分支的 set 方法，旧分支的值会自动清除，同一时间只会保留一个生效字段。
问题 2 oneof 怎么连的时候编号冲突会出现什么问题
回答 2 oneof 怎么连编写 proto 的时候，如果 oneof 内部字段编号和 message 外层字段编号冲突，protoc 编译会直接报错，无法生成目标代码，所以定义的时候必须统一规划全部字段编号。
问题 3 oneof 怎么连之后怎么判断当前选中的是哪一个分支
回答 3 oneof 怎么连赋值完成之后，可以调用生成代码里面自带的 case 查询方法，拿到当前激活分支的枚举值，根据枚举值编写对应的业务处理逻辑。
【免责申明】
本文内容基于 Protobuf oneof 公开技术规范编写，仅作为技术学习参考，不同版本 protoc 编译器和语言插件行为存在差异，实际项目开发请结合官方文档验证，本文不保证适配所有特殊业务场景，不构成任何开发方案承诺。