Entrada

Salida

¿Qué es Protocol Buffers (Protobuf)?

Protocol Buffers (Protobuf) es un formato de serialización independiente de lenguaje y plataforma desarrollado por Google. Los archivos .proto definen el esquema de mensajes y servicios y se usan mucho con APIs gRPC.

El formateador Protobuf normaliza la indentación (2 espacios por nivel), corrige la alineación de bloques y elimina espacios finales — para ayudar a mantener archivos .proto coherentes y legibles. Consulta la guía de estilo de Protobuf y el código fuente en el repositorio de protobuf en GitHub.

Cómo usarlo

1

Pega el contenido .proto

Pega tu esquema Protocol Buffer en el editor izquierdo o haz clic en Subir para cargar un archivo .proto.

2

Formateo instantáneo

El formateador corrige la indentación (2 espacios por nivel), normaliza la estructura de bloques message y service y elimina espacios finales.

3

Copiar o descargar

Usa el botón Copiar para copiar el resultado o Descargar para guardarlo como archivo .proto.

Ejemplo de formateo

Ejemplo: Formatear una definición de mensaje proto3

Entrada sin formato:

syntax="proto3";package api;message User{string name=1;int32 age=2;repeated string roles=3;bool active=4;}

Salida formateada:

syntax = "proto3";
package api;

message User {
  string name = 1;
  int32 age = 2;
  repeated string roles = 3;
  bool active = 4;
}

Preguntas frecuentes

¿Cuál es la diferencia entre proto2 y proto3?

Proto3 es la sintaxis más nueva y recomendada. Elimina las reglas required/optional, usa valores por defecto más simples y mejora el soporte JSON. El formateador admite ambas versiones.

¿Puedo usarlo para definiciones de servicios gRPC?

Sí. Las definiciones gRPC usan la sintaxis Protobuf estándar con bloques service y rpc, que el formateador maneja correctamente.

¿Se valida la sintaxis Protobuf?

El formateador normaliza la indentación y la estructura de bloques, pero no realiza validación semántica completa. Usa protoc para compilación y validación completas.

¿Qué estilo de indentación usa el formateador para archivos .proto?

El formateador sigue la Guía de estilo oficial de Protobuf, que recomienda 2 espacios por nivel de indentación. Los bloques anidados dentro de message, service y enum se indentan de forma consistente.

Herramientas relacionadas