Input

Output

Cos'è Protocol Buffers (Protobuf)?

Protocol Buffers (Protobuf) è un formato di serializzazione dati neutrale rispetto a linguaggio e piattaforma, sviluppato da Google. I file .proto definiscono lo schema di messaggi e servizi e sono usati molto con le API gRPC.

Il formattatore Protobuf normalizza l'indentazione (2 spazi per livello), corregge l'allineamento dei blocchi e rimuove gli spazi finali — aiutando i team a mantenere file di schema .proto coerenti e leggibili. Consulta la guida allo stile Protobuf e il codice sorgente nel repository GitHub di protobuf.

Come usarlo

Incolla il contenuto del .proto

Incolla lo schema Protocol Buffer nell'editor a sinistra oppure fai clic su Carica per aprire un file .proto.

Formattazione immediata

Il formattatore corregge l'indentazione (2 spazi per livello), normalizza la struttura dei blocchi message e service e rimuove gli spazi finali.

Copia o scarica

Usa il pulsante Copia per copiare il risultato oppure Scarica per salvarlo come file .proto.

Esempio di formattazione

Esempio: Formattare una definizione di messaggio proto3

Input non formattato:

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

Output formattato:

syntax = "proto3";
package api;

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

Domande frequenti

Qual è la differenza tra proto2 e proto3?

Proto3 è la sintassi più recente e consigliata. Rimuove le regole required/optional, usa default più semplici e ha un migliore supporto per la serializzazione JSON. Il formattatore supporta entrambe le versioni.

Posso usarlo per definizioni di servizi gRPC?

Sì. Le definizioni gRPC usano la sintassi Protobuf standard con blocchi service e rpc, gestiti correttamente dal formattatore.

Il formattatore convalida la sintassi Protobuf?

Il formattatore normalizza indentazione e struttura dei blocchi ma non esegue una validazione semantica completa. Usa protoc per compilazione e validazione complete.

Quale stile di indentazione usa il formattatore per i file .proto?

Il formattatore segue la guida allo stile ufficiale Protobuf, che raccomanda 2 spazi per livello di indentazione. I blocchi annidati all'interno di dichiarazioni message, service e enum sono tutti indentati in modo coerente.

Formattatore Protobuf