Protobuf и protoc

Protocol Buffers в Go (Protobuf) — бинарный формат сериализации Google с независимостью от языка, используемый для определения строго типизированных API-контрактов в .proto-файлах, которые protoc компилирует в Golang-структуры, код сериализации и заглушки gRPC-сервисов через плагины protoc-gen-go и protoc-gen-go-grpc. Сгенерированный код находится в *.pb.go-файлах и предоставляет функции proto.Marshal и proto.Unmarshal для кодирования и декодирования сообщений, которые значительно компактнее и быстрее при сериализации, чем JSON, — что делает Protocol Buffers в Go стандартным выбором для высоконагруженного межсервисного взаимодействия. Protocol Buffers в Go поддерживают все примитивные типы, вложенные сообщения, поля oneof для суммовых типов, repeated для массивов и поля map<K, V> с гарантированной прямой и обратной совместимостью, если номера полей не переиспользуются. Плагин protoc-gen-validate добавляет декларативные правила валидации полей к .proto-файлам, а grpc-gateway может генерировать REST/JSON реверс-прокси из того же proto-определения, позволяя gRPC- и HTTP-клиентам обращаться к одному Golang-сервису. Понимание Protocol Buffers в Go — обязательное условие для gRPC-разработки и любого Golang-сервиса, которому необходимо эффективно обмениваться данными с не-Go системами.

Как это работает

Protobuf и protoc — HTTP/2-based RPC с Protocol Buffers (.proto) как языком схемы. protoc + protoc-gen-go-grpc генерируют Go-server + client stubs из .proto-файлов. Streaming-варианты (unary, server-streaming, client-streaming, bidi). Reflection для introspection (grpcurl). Connect-go (альтернатива Buf) даёт gRPC-совместимые HTTP/1 + HTTP/2 серверы — interoperable с gRPC-клиентами. gRPC-Gateway экспонирует gRPC-сервисы как REST + OpenAPI.

Когда применять

gRPC — для internal service-to-service, когда важны latency + schema-дисциплина; типизированные контракты ловят много багов на compile time. В паре с Buf — для build + lint proto-файлов. Для публичных API — gRPC-Gateway или Connect для REST/HTTP рядом. Для browser-to-server Connect-go чище, чем gRPC-Web. Избегайте gRPC для одноразовых скриптов или крошечных сервисов — REST проще.

Типичные ошибки

Ловушки Protobuf и protoc: регенерация proto-файлов без коммита (CI ломается из-за отсутствия сгенерированного кода); breaking changes в .proto без bump версии (клиенты валятся непонятным образом); огромные proto-пакеты, затрагивающие каждый сервис на изменение; игнор context.Context deadlines (вызовы висят навеки).

Связанные понятия

• gRPC и Protobuf
• gRPC сервер и клиент
• Streaming RPC
• Interceptors