Klistra in din trasiga .proto här och klicka på "Fixa Protobuf!!" för att reparera denAnge ogiltig .proto

Vad är Protobuf-fixaren?

Har du en trasig .proto-fil? protoc kraschar på ett enda saknat semikolon, en oavslutad message-kropp eller en vilsen klammer, och resten av filen blir oanvändbar tills du hittar felet. Det här verktyget läser trasiga Protocol Buffers-scheman och fixar problemen automatiskt — klistra in det och vi lämnar tillbaka en ren version.

Den kollar först sakerna som protoc snubblar på: en saknad syntax = "proto3"; högst upp, saknade semikolon på fältrader, obalanserade {} i nästlade message/enum-kroppar, samt citat- och import-problem. Resultatet följer samma regler som beskrivs i den officiella proto3-språkguiden och proto3-grammatikreferensen, så det du får tillbaka är ett schema som protoc faktiskt kommer att acceptera.

Inga filuppladdningar, ingen schemadelning — din .proto stannar i den här fliken. Fixa den på sekunder och kom tillbaka till att generera bindningar.

Så Använder Du Protobuf-fixaren

Tre steg. Funkar på scheman dragna ur ett repo, kopierade ur en code review, eller handredigerade och nu trasiga.

Klistra In Trasig .proto eller Ladda Exempel

Släng in det trasiga schemat i den vänstra editorn. Tryck på Exempel-.proto för att ladda ett exempel med de typiska misstagen — ett saknat semikolon efter ett fält, en message-kropp som aldrig stängs, och ett vilset saknat semikolon på syntax-raden. Exempel på trasig proto:

syntax = "proto3"
message LineItem {
  string sku = 1;
  int32 quantity = 2
  double unit_price = 3;

Två fel här: inget semikolon efter syntax-deklarationen, och LineItem-blocket stängs aldrig. Båda är typiska för det fixaren reparerar.

Klicka på Fixa Protobuf!!

Tryck på den gröna Fixa Protobuf!!-knappen. Fixaren läser schemat, återställer saknade semikolon, balanserar {}-klamrar, normaliserar syntax-deklarationen och citerar imports korrekt. Fält-taggar, namn och typer lämnas i fred.

Granska Den Fixade Outputen

Den högra panelen har den reparerade .proto-filen. Släng tillbaka den i ditt projekt och kör protoc för att bekräfta. För scheman som driver RPC-tjänster, gör också en sanity-check med vår Protobuf-validator innan du genererar bindningar. Allt körs i din webbläsare — schemat lagras aldrig.

När Du Faktiskt Skulle Använda Det Här

Rädda ett Handredigerat Schema

Du la till ett nytt fält, råkade ta bort en klammer, och nu rapporterar protoc fel tre meddelanden längre ner. Klistra in filen, få tillbaka klammern, och fortsätt — istället för att leta igenom ett 400 rader långt schema med ögonen.

Fixa LLM-genererad .proto

Bett en LLM skriva ett utkast till en .proto från ett JSON-exempel? Strukturen är oftast rätt men den glömmer syntax = "proto3";, tappar semikolon eller paketerar saker i markdown-staket. Fixaren rensar upp det.

Reparera Efter en Dålig Merge

Konfliktmarkörer löstes slarvigt och .proto kompilerar inte. Kör den genom fixaren för att få ihop strukturen igen så du kan granska den faktiska semantiska diffen i Git istället för att slåss med syntax.

Återställ Scheman från Loggar eller Dokumentation

Drog en .proto ur en wiki-sida, en gammal PR-beskrivning eller en OCR av en skärmdump? Texten har oftast vilsna tecken och trasig indentering. Fixaren får tillbaka den till något protoc accepterar.

Vanliga Frågor

Lagras eller skickas min .proto-fil någonstans?

Ditt schema skickas till vår backend bara för att köra reparationen, och vi sparar det inte — så fort svaret kommer tillbaka är det borta. Inget loggas tillsammans med dina data, och det finns inga tredjepartstrackers i request-vägen. Om du har ett känsligt schema (interna tjänster, ej släppta API:er), maska identifierare innan du klistrar in, på samma sätt som du skulle göra om du delade det i en publik bugg-rapport.

Vilka typer av fel fixar den faktiskt?

De vanliga som protoc avvisar: saknad eller fel syntax-deklaration (den lägger till syntax = "proto3"; om den saknas), saknade semikolon på fält/option/enum-rader, obalanserade {} i message/enum/service-block, saknade eller omatchade citationstecken på string-options och imports, och uppenbara stavfel i nyckelord som repeated eller optional.

Kommer den att ändra mina fält-tag-nummer eller döpa om något?

Nej. Fixaren får uttryckligen i uppdrag att bara reparera syntax — aldrig att döpa om messages/fält, ändra tag-nummer eller hitta på nya fält. Tag-nummer är en del av ditt wire-format; att röra dem skulle bryta bakåtkompatibilitet. Om resultatet någonsin ser ut som om det ändrat semantiskt innehåll, behandla det som en bugg och commita inte.

Stödjer den proto2 lika mycket som proto3?

Ja, för fixar på syntax-nivå — saknade semikolon, obalanserade klamrar och felaktiga syntax-deklarationer hanteras likadant oavsett. Fixaren respekterar det som står på syntax-raden; den vänder inte ett proto2-schema till proto3 (de har olika semantik kring required/optional och defaults).

Varför inte bara köra protoc och läsa felet?

Det borde du — protoc är källan till sanning. Men felen pekar på en plats i taget, och en saknad klammer kan kaskada till tio efterföljande fel. Fixaren är till för när du vill ha hela filen avblockad i ett svep, sen kör du protoc igen för att bekräfta. Tänk på det som en första svepning, inte en ersättning.

Klarar den stora scheman med många imports?

Ja, upp till några tusen rader per request. Reparationen tittar bara på filen du klistrar in — den jagar inte import-satser eller hämtar externa scheman. Om ditt schema importerar google/protobuf/timestamp.proto eller andra välkända typer bevaras de imports som de är.

Andra Protobuf-verktyg

Att fixa syntaxen är första steget. När schemat kompilerar tar de här verktygen det resten av vägen: