Eingabe

Ausgabe

Was sind Protocol Buffers (Protobuf)?

Protocol Buffers (Protobuf) ist ein sprach- und plattformneutrales Serialisierungsformat von Google. .proto-Dateien definieren Schemas für Nachrichten und Dienste und werden häufig mit gRPC-APIs verwendet.

Der Protobuf-Formatierer normalisiert die Einrückung (2 Leerzeichen pro Ebene), korrigiert Blockausrichtung und entfernt nachgestellte Leerzeichen — für konsistente, lesbare .proto-Dateien. Den offiziellen Protobuf-Stilguide und den Quellcode finden Sie im protobuf-GitHub-Repository.

So verwenden Sie das Tool

.proto-Inhalt einfügen

Fügen Sie Ihr Protocol-Buffer-Schema in den linken Editor ein oder klicken Sie auf Hochladen, um eine .proto-Datei zu laden.

Sofortige Formatierung

Der Formatierer korrigiert die Einrückung (2 Leerzeichen pro Ebene), normalisiert die Struktur von message- und service-Blöcken und entfernt nachgestellte Leerzeichen.

Kopieren oder herunterladen

Verwenden Sie die Schaltfläche Kopieren, um das Ergebnis zu kopieren, oder Herunterladen, um es als .proto-Datei zu speichern.

Formatierungsbeispiel

Beispiel: Eine proto3-Nachrichtendefinition formatieren

Unformatierte Eingabe:

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

Formatierte Ausgabe:

syntax = "proto3";
package api;

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

Häufig gestellte Fragen

Was ist der Unterschied zwischen proto2 und proto3?

Proto3 ist die neuere und empfohlene Syntax. Sie entfernt required/optional-Feldregeln, nutzt einfachere Standardwerte und bietet bessere JSON-Serialisierung. Der Formatierer unterstützt beide Versionen.

Kann ich das für gRPC-Dienstdefinitionen verwenden?

Ja. gRPC-Dienste nutzen die übliche Protobuf-Syntax mit service- und rpc-Blöcken, die der Formatierer korrekt verarbeitet.

Wird die Protobuf-Syntax validiert?

Der Formatierer normalisiert Einrückung und Blockstruktur, führt aber keine vollständige semantische Validierung durch. Verwenden Sie protoc für vollständige Kompilierung und Validierung.

Welchen Einrückungsstil verwendet der Formatierer für .proto-Dateien?

Der Formatierer folgt dem offiziellen Protobuf-Stilguide, der 2 Leerzeichen pro Einrückungsebene empfiehlt. Verschachtelte Blöcke in message-, service- und enum-Deklarationen werden durchgehend einheitlich eingerückt.

Protobuf-Formatierer