KI auf dem Gerät – professionell und privat.

Dokumente

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.

ZeichenIn JSON geschrieben alsPflicht?
Doppeltes Anführungszeichen "\"Ja, sonst endet der String
Backslash \\\Ja, sonst beginnt eine Escape-Sequenz
Zeilenumbruch (Line Feed)\nJa, ein echter Umbruch in einem String ist ungültig
Wagenrücklauf\rJa
Tabulator\tJa
Rückschritt, Seitenvorschub\b, \fJa
Andere Steuerzeichen U+0000 bis U+001F\u0000 bis \u001fJa, 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 DE00Nein, beides ist gültig
Apostroph 'unverändertNein, 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 SituationRichtungWas Sie erhalten
Eine mehrzeilige SQL-Abfrage, ein Zertifikat oder eine Vorlage soll ein einziger JSON-Wert werdenEscapeEine Zeile mit \n an den Stellen der Umbrüche
Ein String voller Anführungszeichen soll in eine Konfigurationsdatei oder eine TestdateiEscapeJedes " als \" geschrieben
Eine Logzeile oder ein API-Feld liest sich wie eine einzige Reihe aus \n und \"UnescapeDer lesbare Text mit echten Zeilenumbrüchen
Ein Feld enthält ein ganzes JSON-Dokument als StringUnescapeDas innere Dokument, bereit für den JSON-Formatierer
Sie wollen prüfen, ob der escapte Text das sagt, was Sie denkenEscape, dann TauschenEin 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

1

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.

2

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.

3

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.

4

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.

5

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 unescapen

JSON 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.

OptionEinschalten, wennKosten
Nicht-ASCII als \uXXXX escapenDer 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 \/ escapenDer String steht in einem HTML-Script-Block, in dem </script> innerhalb eines Strings das Tag zu früh schließen würdeEin 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 warenSechs 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 UrsacheLösung
Der String wird nie geschlossenDer Wert wurde durch eine Längengrenze im Log oder eine unvollständige Kopie abgeschnittenFügen Sie den ganzen Wert ein oder ergänzen Sie das schließende Anführungszeichen
Unbekannte Escape-SequenzEin Backslash vor einem Buchstaben, den JSON nicht definiert, etwa \' oder \U in einem Windows-PfadVerdoppeln Sie den Backslash oder escapen Sie stattdessen den Originaltext
Unvollständige \u-SequenzAuf \u folgen nicht genau vier Hexadezimalziffern\u12 ist ungültig; schreiben Sie \u0012
Rohes SteuerzeichenEin echter Zeilenumbruch oder Tabulator steht im String, oft nach dem Kopieren aus einem TerminalWenden Sie stattdessen Escape auf den Text an
Zusätzlicher Inhalt nach dem StringZwei Strings nebeneinander oder Text nach dem schließenden AnführungszeichenWandeln Sie einen Wert nach dem anderen um
Das ist ein JSON-Dokument, kein StringSie haben ein Objekt oder ein Array eingefügtNutzen 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.

Weiterlesen

Mehr zu Dokumente →