JSON escapen und unescapen: Welche Zeichen maskiert werden müssen und wie Sie doppelt escapte Strings reparieren
JSON Escape und Unescape erklärt: welche Zeichen JSON maskieren muss, wie JSON in einen String gehört und wie Sie doppelt escapte Anführungszeichen reparieren.
Aktualisiert am 8. November 20269 Min. Lesezeit
Um einen Text für JSON zu escapen, setzen Sie vor jedes doppelte Anführungszeichen und vor jeden Backslash einen Backslash, ersetzen Zeilenumbrüche und Tabulatoren durch \n, \r und \t und schließen das Ergebnis in doppelte Anführungszeichen ein. Unescape macht das Gegenteil: Aus \" wird wieder ein Anführungszeichen und aus \n wieder ein echter Zeilenumbruch. Das ist fast das ganze Regelwerk, und das Werkzeug JSON-String Escape Unescape wendet es exakt an, in beide Richtungen. Die meisten Probleme entstehen rund um diese Regeln: JSON, das in einen anderen JSON-String eingefügt wird, Backslashes, die sich bei jedem Speichern eines Werts vervielfachen, und Zeichen, die in JSON erlaubt sind, aber den Ort zerstören, an dem Sie sie einfügen. Dieser Leitfaden behandelt jeden dieser Fälle.
Was JSON-Escaping bedeutet und welche Zeichen es brauchen
Ein JSON-String beginnt und endet mit einem doppelten Anführungszeichen. Alles darin, was für das Ende des Strings oder den Beginn einer Escape-Sequenz gehalten werden könnte, muss anders geschrieben werden. Der JSON-Standard (RFC 8259) schreibt das Escapen von genau drei Zeichengruppen vor: dem doppelten Anführungszeichen, dem Backslash und allen Steuerzeichen von U+0000 bis U+001F, darunter Zeilenumbruch und Tabulator. Alles andere, auch Umlaute, Emojis, Apostrophe und der normale Schrägstrich, darf unverändert stehen.
| Zeichen | In JSON geschrieben als | Pflicht? |
|---|---|---|
| Doppeltes Anführungszeichen " | \" | Ja, sonst endet der String |
| Backslash \ | \\ | Ja, sonst beginnt eine Escape-Sequenz |
| Zeilenumbruch (Line Feed) | \n | Ja, ein echter Umbruch in einem String ist ungültig |
| Wagenrücklauf | \r | Ja |
| Tabulator | \t | Ja |
| Rückschritt, Seitenvorschub | \b, \f | Ja |
| Andere Steuerzeichen U+0000 bis U+001F | \u0000 bis \u001f | Ja, eine Kurzform gibt es nicht |
| Schrägstrich / | / oder \/ | Nein, beides ist gültig |
| Nicht-ASCII wie é oder 😀 | unverändert, oder \u00e9 und das Paar D83D DE00 | Nein, beides ist gültig |
| Apostroph ' | unverändert | Nein, und \' ist keine gültige Escape-Sequenz |
Die letzte Zeile erwischt viele. JavaScript und Python akzeptieren \' in einem String, daher wirkt es selbstverständlich, doch JSON definiert es nicht. Ein Parser, der auf \' stößt, bricht mit einem Fehler ab. In JSON braucht ein Apostroph überhaupt kein Escaping, und einfache Anführungszeichen dürfen nie einen String umschließen.
Escape oder Unescape: was Sie brauchen
| Ihre Situation | Richtung | Was Sie erhalten |
|---|---|---|
| Eine mehrzeilige SQL-Abfrage, ein Zertifikat oder eine Vorlage soll ein einziger JSON-Wert werden | Escape | Eine Zeile mit \n an den Stellen der Umbrüche |
| Ein String voller Anführungszeichen soll in eine Konfigurationsdatei oder eine Testdatei | Escape | Jedes " als \" geschrieben |
| Eine Logzeile oder ein API-Feld liest sich wie eine einzige Reihe aus \n und \" | Unescape | Der lesbare Text mit echten Zeilenumbrüchen |
| Ein Feld enthält ein ganzes JSON-Dokument als String | Unescape | Das innere Dokument, bereit für den JSON-Formatierer |
| Sie wollen prüfen, ob der escapte Text das sagt, was Sie denken | Escape, dann Tauschen | Ein Hin- und Rückweg, der das Original exakt zurückgibt |
Escapen ist weder Verschlüsseln noch Komprimieren. Es ändert nur, wie Sonderzeichen geschrieben werden, damit ein Parser sie als Text liest. Wenn Sie Binärdaten wie ein Bild in Text verwandeln möchten, ist das eine andere Aufgabe, erklärt unter Was ist Base64-Kodierung. Geht der Text in eine Webadresse, braucht er stattdessen Prozentkodierung mit dem URL-Encoder.
Einen JSON-String escapen oder unescapen, Schritt für Schritt
Die Richtung wählen
Öffnen Sie das JSON-Escape-Werkzeug und wählen Sie Escape, um einfachen Text in ein JSON-String-Literal zu verwandeln, oder Unescape, um einen JSON-String wieder in Text zu verwandeln.
Den Text hinzufügen
Fügen Sie den Text in das Feld ein und klicken Sie auf Diesen Text verwenden, oder ziehen Sie eine .json-, .txt-, .log-, .ndjson- oder ähnliche Textdatei in den Ablagebereich. UTF-8 und UTF-16 werden beide erkannt.
Die Optionen einstellen
Bei Escape ist Ergebnis in Anführungszeichen setzen standardmäßig aktiv; schalten Sie es aus, wenn Sie das Ergebnis zwischen Anführungszeichen einfügen, die in Ihrem Code schon stehen. Die drei anderen Schalter werden weiter unten erklärt. Bei Unescape lassen Sie Abzuschälende Ebenen auf Automatisch (bis 10), es sei denn, Sie möchten auf halbem Weg anhalten.
Ausführen und die Zahlen prüfen
Klicken Sie auf Escape oder Unescape. Das Ergebnis erscheint neben der Quelle, mit Zeichen- und Byteanzahl und einem Wachstumsfaktor, der wichtig ist, wenn der Wert in eine Spalte oder unter eine Größengrenze für Anfragen passen muss.
Kopieren, herunterladen oder tauschen
Kopieren Sie das Ergebnis, laden Sie es als Textdatei herunter, oder klicken Sie auf Tauschen, um es in umgekehrter Richtung zurück in die Eingabe zu schicken und zu bestätigen, dass Sie Ihren Originaltext zurückerhalten.
Verwandeln Sie Text in einen JSON-String oder dekodieren Sie einen zurück, verschachtelte Ebenen werden automatisch entfernt. Kostenlos: eine Datei oder eingefügter Text bis 10 MB, mit allen Optionen. Pro: keine feste Größengrenze und bis zu 20 Dateien auf einmal, als ein ZIP heruntergeladen. Alles läuft auf Ihrem Gerät, nicht auf unseren Servern.
JSON escapen oder unescapenJSON in einen JSON-String packen
Manchmal muss ein ganzes JSON-Dokument als einzelner String reisen: der Inhalt eines Webhooks in einer Datenbankspalte, ein Einstellungsobjekt in einer Warteschlange, die nur Text annimmt, oder das Nachrichtenfeld eines Log-Ereignisses. Dazu escapen Sie das Dokument. Aus dem Objekt {"name":"Ana"} wird der String "{\"name\":\"Ana\"}". Jedes innere Anführungszeichen bekommt einen Backslash, und das Ganze bekommt ein äußeres Paar Anführungszeichen.
Prüfen Sie vor dem Escapen, ob das Dokument gültig ist: Ein Objekt mit fehlendem Komma ergibt escapt einen völlig gültigen String, der ein kaputtes Dokument enthält. Schicken Sie es zuerst durch den JSON-Validator. Kommt es auf die Größe an, entfernen Sie die Einrückung vor dem Escapen mit dem JSON-Minifier: Jeder Zeilenumbruch eines formatierten Dokuments wird zu einem zweistelligen \n, und die Einrückungsleerzeichen bleiben erhalten, deshalb ist ein formatiertes, escaptes Dokument deutlich größer als ein minifiziertes, escaptes.
Umgekehrt gilt: Liefert eine API ein Feld, dessen Wert mit "{\" beginnt, haben Sie ein eingebettetes Dokument vor sich. Unescapen Sie es einmal, und Sie erhalten echtes JSON zurück, das Sie dann formatieren und lesen können.
Doppeltes Escaping: warum sich die Backslashes vervielfachen
Bei jedem Escapen eines Werts wird jeder vorhandene Backslash verdoppelt, und jedes Anführungszeichen bekommt einen weiteren. Ein Zeilenumbruch, der nach einer Runde \n ist, wird nach zwei Runden zu \\n und nach drei zu \\\\n. Einmal unescapt sieht er immer noch escapt aus, weshalb viele glauben, das Werkzeug habe nicht funktioniert. Es hat funktioniert: Es hat eine von mehreren Ebenen entfernt.
Lassen Sie Abzuschälende Ebenen auf Automatisch, dann macht das Werkzeug weiter, solange das Ergebnis noch ein JSON-String in Anführungszeichen ist, bis zu zehn Ebenen, und meldet danach, wie viele es entfernt hat. Wählen Sie eine Zahl von 1 bis 10, um bei einer inneren Ebene anzuhalten, etwa um ein eingebettetes Dokument an den Formatierer zu geben, statt es weiter zu dekodieren. Normaler Text, der zufällig \n enthält, wird nie abgeschält, denn eine Ebene wird nur entfernt, wenn der Rest sich tatsächlich als JSON-String parsen lässt.
Die üblichen Ursachen für doppeltes Escaping, damit Sie es an der Quelle beheben können:
- Zweimal serialisieren. Wer JSON.stringify in JavaScript oder json.dumps in Python auf etwas anwendet, das schon ein JSON-String ist, verpackt es erneut. Serialisieren Sie das Objekt einmal, im letzten Schritt.
- Logging-Bibliotheken. Strukturierte Logger escapen die Nachricht, und manche Pipelines escapen beim Weiterleiten das ganze Ereignis ein zweites Mal.
- Erst von Hand, dann per Code escapen. Wer selbst \" einfügt und den Text dann durch einen Serialisierer schickt, erhält \\\".
- Aus einem Debugger oder einer Konsole kopieren. Manche Konsolen zeigen Strings in ihrer escapten Form. Wer diese Anzeige kopiert und erneut escapt, fügt eine Ebene hinzu.
- Windows-Pfade. C:\Users\Ana muss in JSON als C:\\Users\\Ana geschrieben werden. Unescapt eingefügt ergibt sich \U, keine gültige Escape-Sequenz, und doppelt escapt stehen vier Backslashes pro Trennzeichen da.
Escapen passend zum Ziel des Strings
Alles Folgende ergibt in jedem Fall gültiges JSON. Die drei zusätzlichen Schalter im Werkzeug gibt es, weil das Ziel manchmal Wert darauf legt.
| Option | Einschalten, wenn | Kosten |
|---|---|---|
| Nicht-ASCII als \uXXXX escapen | Der Wert durchläuft ein System, das UTF-8 nicht zuverlässig verarbeitet, oder Sie wollen reines ASCII in der Versionsverwaltung | é wächst von 2 Byte auf 6, ein Emoji von 4 Byte auf 12, als zwei Escapes |
| Schrägstriche als \/ escapen | Der String steht in einem HTML-Script-Block, in dem </script> innerhalb eines Strings das Tag zu früh schließen würde | Ein Byte mehr pro Schrägstrich |
| Zeilentrenner escapen (U+2028, U+2029) | Das Literal wird für ältere Engines in JavaScript-Quellcode eingefügt, wo diese beiden unsichtbaren Zeichen ein Syntaxfehler waren | Sechs statt drei Byte pro Zeichen |
Das Einfügen in Code ist ein eigener Fall. Ein JSON-String-Literal ist meist auch ein gültiger String in JavaScript, Python und Go, daher können Sie das escapte Ergebnis bei ausgeschalteter Anführungszeichen-Option zwischen Ihre eigenen Anführungszeichen setzen. In einer Shell umschließen Sie den JSON-Inhalt mit einfachen Anführungszeichen, dann brauchen die doppelten Anführungszeichen darin kein weiteres Escaping; in der Windows-Eingabeaufforderung gibt es keine Strings in einfachen Anführungszeichen, deshalb muss jedes innere doppelte Anführungszeichen für die Befehlszeile als \" geschrieben werden, eine zweite, eigene Ebene über der von JSON.
Wenn Unescape scheitert: was die Fehlermeldung bedeutet
| Meldung | Übliche Ursache | Lösung |
|---|---|---|
| Der String wird nie geschlossen | Der Wert wurde durch eine Längengrenze im Log oder eine unvollständige Kopie abgeschnitten | Fügen Sie den ganzen Wert ein oder ergänzen Sie das schließende Anführungszeichen |
| Unbekannte Escape-Sequenz | Ein Backslash vor einem Buchstaben, den JSON nicht definiert, etwa \' oder \U in einem Windows-Pfad | Verdoppeln Sie den Backslash oder escapen Sie stattdessen den Originaltext |
| Unvollständige \u-Sequenz | Auf \u folgen nicht genau vier Hexadezimalziffern | \u12 ist ungültig; schreiben Sie \u0012 |
| Rohes Steuerzeichen | Ein echter Zeilenumbruch oder Tabulator steht im String, oft nach dem Kopieren aus einem Terminal | Wenden Sie stattdessen Escape auf den Text an |
| Zusätzlicher Inhalt nach dem String | Zwei Strings nebeneinander oder Text nach dem schließenden Anführungszeichen | Wandeln Sie einen Wert nach dem anderen um |
| Das ist ein JSON-Dokument, kein String | Sie haben ein Objekt oder ein Array eingefügt | Nutzen Sie den Formatierer oder den Validator; Unescape verarbeitet einen einzelnen String |
Jede Meldung nennt Zeile und Spalte und zeigt den umgebenden Text, sodass Sie auf einer langen Logzeile genau sehen, welcher Backslash das Problem ist, statt ihn suchen zu müssen.
Häufige Fragen
Wie escape ich doppelte Anführungszeichen in JSON?
Setzen Sie vor jedes einen Backslash, sodass aus " ein \" wird. Jeder Backslash, der schon im Text steht, muss vorher verdoppelt werden, sonst wird das Ergebnis anders gelesen. Wenn Sie den Text im Modus Escape einfügen, geschieht beides, und das Ergebnis steht in Anführungszeichen.
Wie unescape ich einen JSON-String online?
Wählen Sie Unescape, fügen Sie den String mit oder ohne seine Anführungszeichen ein und starten Sie. Lassen Sie die Ebenen auf Automatisch, wenn der Wert mehr als einmal escapt worden sein könnte; das Werkzeug meldet, wie viele Ebenen es entfernt hat.
Warum steht in meinem JSON vor jedem Anführungszeichen ein Backslash?
Der Wert wurde als String statt als Objekt gespeichert, meist weil er zweimal serialisiert wurde. Unescapen Sie ihn, um das innere JSON zurückzubekommen, und korrigieren Sie dann den Code, damit er nur einmal serialisiert.
Darf ich in JSON einfache Anführungszeichen oder \' verwenden?
Nein. JSON-Strings müssen doppelte Anführungszeichen verwenden, und \' ist keine gültige Escape-Sequenz. Ein Apostroph in einem String mit doppelten Anführungszeichen kann einfach so stehen und braucht keinen Backslash.
Muss ich Schrägstriche in JSON escapen?
Nein. Sowohl / als auch \/ sind gültig und bedeuten dasselbe. Escapen hilft nur, wenn das JSON in einem HTML-Script-Tag steht, wo der Text </script> das Tag sonst schließen würde.
Wie viel Text kann ich kostenlos escapen?
Die kostenlose Version verarbeitet eine Datei oder eingefügten Text bis 10 MB, mit allen Optionen und allen Unescape-Tiefen. Pro hebt die feste Grenze auf, arbeitet bis zu dem, was Ihr Gerät bewältigt, und nimmt bis zu 20 Dateien auf einmal.