JSON-Schlüssel von camelCase in snake_case umwandeln

Inhalt
Wenn Ihre API-Antwort in snake_case ankommt, Ihr Frontend-Code aber camelCase verwendet, müssen Sie die Schlüsselnamen nicht jedes Mal von Hand ändern. Es genügt, eine einzige Umwandlungsregel zu kennen.
camelCase, snake_case, PascalCase und kebab-case beruhen alle auf demselben Prinzip: Es wird festgelegt, wie man Wörter trennt und wieder zusammensetzt. In diesem Artikel erfahren Sie, wie Sie diese Regeln von Hand anwenden und welche Sonderfälle automatische Konverter häufig übersehen.
Zusammenfassung ① camelCase, snake_case, PascalCase und kebab-case sind unterschiedliche Schreibweisen für dieselben Daten – sie unterscheiden sich nur darin, wie Wörter getrennt werden. ② Bei der Umwandlung wird der Schlüssel anhand der Position von Großbuchstaben sowie von Unterstrichen und Bindestrichen in Wörter zerlegt und anschließend in der Zielschreibweise wieder zusammengesetzt. ③ Dieselbe Regel gilt rekursiv auch für Schlüssel in verschachtelten Objekten und Arrays – ohne Begrenzung der Verschachtelungstiefe.
In welchen Situationen dieses Problem auftritt
Das Problem entsteht, wenn die Konventionen unterschiedlicher Programmiersprachen und Frameworks über eine gemeinsame API aufeinandertreffen. Ist das Backend mit einem Python-Framework umgesetzt, liefert die Antwort-JSON die Schlüssel meist in snake_case (user_id, created_at).
Ist das Frontend dagegen in JavaScript oder TypeScript geschrieben, folgt der Code häufig der camelCase-Konvention (userId, createdAt).
Verwenden Sie die Antwort unverändert, steht in einer Datei plötzlich user_id neben userName. Bei wenigen Feldern lässt sich das mit einer von Hand geschriebenen Mapping-Funktion lösen. Bei Dutzenden Feldern mit verschachtelten Objekten und Arrays übersieht man aber leicht einen Schlüssel in einer tiefen Ebene.
Schreibweisen ohne Tool von Hand umwandeln
Alle vier Schreibweisen funktionieren nach demselben Prinzip: Sie zerlegen den Schlüsselnamen in „Wörter“ und setzen diese Wörter dann nach der jeweiligen Regel wieder zusammen.
Für die Zerlegung gibt es nur zwei Kriterien. Bei Schreibweisen ohne Trennzeichen wie camelCase und PascalCase beginnt ein neues Wort an jeder Stelle, an der ein Großbuchstabe steht. Bei Schreibweisen mit Trennzeichen wie snake_case und kebab-case wird an jedem Unterstrich (_) bzw. Bindestrich (-) getrennt.
Nach der Zerlegung setzen Sie die Wörter nach den folgenden Regeln wieder zusammen.
| Schreibweise | Regel zum Zusammensetzen | Beispiel (user, id) |
|---|---|---|
| camelCase | Erstes Wort kleingeschrieben, bei allen weiteren Wörtern nur der erste Buchstabe groß, ohne Trennzeichen | userId |
| snake_case | Alle Wörter kleingeschrieben, verbunden mit Unterstrich (_) | user_id |
| PascalCase | Bei allen Wörtern der erste Buchstabe groß, ohne Trennzeichen | UserId |
| kebab-case | Alle Wörter kleingeschrieben, verbunden mit Bindestrich (-) | user-id |
Verschachtelte Objekte und Arrays: dieselbe Regel
Angenommen, Sie wandeln { "user_id": 1, "profile": { "email_address": "a@test.com" } } in camelCase um. Dann wird user_id am Unterstrich zerlegt und zu userId. Auch email_address im verschachtelten Objekt profile wird nach derselben Regel zu emailAddress.
Wenn Sie nur die Schlüssel der obersten Ebene ändern und die inneren Objekte unverändert lassen, ist das Ergebnis nur zur Hälfte umgewandelt. Die Regel muss deshalb auf jeder Verschachtelungsebene erneut angewendet werden.
Auch bei Arrays bleibt die Regel gleich. Der Schlüssel des Arrays selbst, etwa order_list, wird zu orderList. Sind die Elemente des Arrays Objekte wie { order_id: 1 }, werden auch deren Schlüssel nach derselben Regel umgewandelt. Bestehen die Elemente aus Strings oder Zahlen (z. B. "tags": ["new", "sale"]), gibt es keine Schlüssel, die sich ändern ließen – die Werte bleiben unverändert.
Automatisierung mit regulären Ausdrücken
Wenn Sie diesen Vorgang programmatisch umsetzen, nehmen Sie in der Regel reguläre Ausdrücke. Eine Funktion für camelCase sucht den Kleinbuchstaben nach einem „-“ oder „_“, macht ihn zum Großbuchstaben und entfernt dabei das Trennzeichen – das gelingt mit einer einzigen Ersetzung.
Eine Funktion für snake_case oder kebab-case geht umgekehrt vor: Sie fügt vor jedem Großbuchstaben ein Trennzeichen ein und wandelt anschließend alles in Kleinbuchstaben um. PascalCase erhalten Sie, indem Sie im camelCase-Ergebnis nur den ersten Buchstaben großschreiben.
Bei wenigen Schlüsseln reicht es völlig, diese Regeln von Hand anzuwenden. Sind die Objekte jedoch tief verschachtelt und gibt es viele Schlüssel, übersieht man beim manuellen Ändern leicht einen Schlüssel an einer verschachtelten Stelle. Unser JSON Key Case Konverter übernimmt diese rekursive Anwendung automatisch.
Mit dem JSON Key Case Konverter ausprobieren.
Kostenlos nutzbar, ohne Anmeldung. Nach einem Klick auf „Konvertieren“ erscheint das Ergebnis sofort.

Häufige Missverständnisse
Die Regel selbst ist einfach. In echten Daten können aber einige Schlüsselformen dazu führen, dass das Ergebnis anders ausfällt als erwartet.
| Situation | Ergebnis |
|---|---|
| Gemischte Bindestriche und Unterstriche (user-id_name) | Beide Trennzeichen werden als Wortgrenze erkannt und bei der Umwandlung in camelCase korrekt zu userIdName zusammengesetzt |
| Schlüssel, der bereits mit einem Großbuchstaben beginnt (UserId) | Weil bei der Umwandlung in snake_case oder kebab-case vor jedem Großbuchstaben ein Trennzeichen eingefügt wird, kann auch vor dem ersten Buchstaben ein Trennzeichen stehen bleiben, etwa _user_id oder -user-id |
| Wert (Value) ist String, Zahl, Boolean oder null | Nur Schlüssel werden umgewandelt; der Inhalt der Werte bleibt unverändert |
| Ungültige JSON-Syntax | Es erfolgt keine Umwandlung; stattdessen wird die von JSON.parse ausgelöste Fehlermeldung unverändert angezeigt |
Schlüssel mit gemischten Trennzeichen oder Großbuchstaben am Anfang
Auch wenn Bindestrich und Unterstrich in einem Schlüssel gemischt vorkommen (user-id_name), müssen Sie sich keine Sorgen machen. Beide Trennzeichen werden als „Beginn eines neuen Wortes“ erkannt, sodass die Umwandlung in camelCase korrekt userIdName ergibt.
Beginnt der ursprüngliche Schlüssel dagegen bereits mit einem Großbuchstaben, wie bei PascalCase (UserId), sollten Sie das Ergebnis genauer prüfen. Die Regel für snake_case und kebab-case fügt „vor jedem Großbuchstaben ein Trennzeichen ein“. Ist schon der erste Buchstabe ein Großbuchstabe, wird auch dort ein Trennzeichen eingefügt, sodass es am Anfang des Ergebnisses stehen bleiben kann.
Sehen Sie am Anfang des Ergebnisses ein Trennzeichen, ist das ein Hinweis darauf, dass der ursprüngliche Schlüssel mit einem Großbuchstaben begann.
Werte (Values) und JSON-Syntaxfehler
Werte (Values) werden nicht umgewandelt. Strings, Zahlen, Booleans und null bleiben unabhängig von der Schreibweise unverändert. Steht in einem Wert zufällig ein String wie user_id, bleibt auch dieser String unverändert.
Ist die JSON-Syntax fehlerhaft, erscheint statt der Umwandlung die Fehlermeldung des Parsers. Typische Ursachen sind nicht zusammenpassende eckige oder geschweifte Klammern, Schlüssel ohne doppelte Anführungszeichen, ein Komma nach dem letzten Eintrag (Trailing Comma) oder einfache statt doppelter Anführungszeichen.
Die Zahl nach „position“ in der Fehlermeldung gibt an, bei welchem Zeichen das Problem auftritt – gezählt ab dem Anfang des Strings, einschließlich Leerzeichen. Prüfen Sie die Stelle und ihre Umgebung, um die Ursache einzugrenzen.
Fazit
- camelCase, snake_case, PascalCase und kebab-case sind Schreibweisen für dieselben Daten; sie unterscheiden sich nur in der Regel, nach der Wörter getrennt und wieder zusammengesetzt werden.
- Maßgeblich für die Zerlegung in Wörter sind die Stellen, an denen Großbuchstaben beginnen, sowie die Positionen von Unterstrichen und Bindestrichen.
- Dieselbe Regel muss auch auf Schlüssel in verschachtelten Objekten und Arrays ohne Begrenzung der Verschachtelungstiefe immer wieder angewendet werden, damit wirklich alle Schlüssel umgewandelt werden.
- Beginnt der ursprüngliche Schlüssel mit einem Großbuchstaben, kann bei der Umwandlung in snake_case oder kebab-case am Anfang des Ergebnisses ein Trennzeichen stehen bleiben.
- Der Inhalt von Werten (Values) wird nicht umgewandelt, und bei ungültiger JSON-Syntax wird die Fehlermeldung des Parsers unverändert angezeigt.
Kostenlos nutzbar, ohne Anmeldung. Nach einem Klick auf „Konvertieren“ erscheint das Ergebnis sofort.
Häufig gestellte Fragen
Werden auch Schlüssel in verschachtelten Objekten oder Arrays konvertiert?
Ja. Ob ein Objekt weitere Objekte enthält oder ein Array Objekte beinhaltet: Der JSON Key Case Konverter durchsucht alle Ebenen rekursiv, ohne Begrenzung der Verschachtelungstiefe, und wandelt jeden Schlüssel nach derselben Regel um.
Ändert sich das Ergebnis automatisch, wenn ich das JSON im Eingabefeld bearbeite?
Nein. Die Konvertierung wird einmalig ausgeführt, wenn Sie auf „Konvertieren“ klicken, und zwar mit der Eingabe zu diesem Zeitpunkt. Nachdem Sie die Eingabe korrigiert haben, müssen Sie erneut auf die Schaltfläche klicken, um ein neues Ergebnis zu erhalten.
Wird auch der Text innerhalb von Werten (Values) umgewandelt, nicht nur die Schlüsselnamen?
Nein. Umgewandelt werden ausschließlich die Schlüsselnamen. Werte wie Strings, Zahlen, Booleans und null bleiben unverändert.
Es erscheint ein JSON-Syntaxfehler: was ist das Problem?
In diesem Fall hält sich die eingegebene Zeichenfolge nicht an die Syntax, die JSON.parse verlangt. Häufige Ursachen sind ein Komma nach dem letzten Eintrag (Trailing Comma), einfache Anführungszeichen oder Schlüssel ohne doppelte Anführungszeichen. Anhand der Positionsangabe (position) in der angezeigten Fehlermeldung sehen Sie, an welchem Zeichen das Problem auftritt.
Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen