JSON in INI umwandeln: Schritt für Schritt und worauf du achten musst

Warum JSON nach INI umwandeln?

Der häufigere Weg ist INI nach JSON, doch es gibt gute Gründe für die Gegenrichtung. Viele ältere Programme, Spiele und Systemwerkzeuge erwarten ihre Konfiguration weiterhin als INI-Datei. Wenn Sie Einstellungen aus einer modernen Anwendung exportiert haben (oft als JSON) und sie in ein Programm überführen wollen, das nur INI versteht, ist die Umwandlung JSON nach INI genau richtig.

Typische Gründe:

• Ein Programm liest seine Konfiguration nur als .ini, Ihre Daten liegen aber als JSON vor.
• Sie möchten eine maschinell erzeugte JSON-Konfiguration für Menschen lesbarer machen, denn INI ist für einfache Einstellungen oft übersichtlicher.
• Sie pflegen Einstellungen zentral als JSON und generieren daraus INI-Dateien für verschiedene Ziele.

Wenn Sie unsicher sind, welches Format für Ihren Fall das richtige ist, hilft der Vergleich im Ratgeber INI oder JSON.

Schritt für Schritt: JSON in INI umwandeln

1. JSON öffnen oder einfügen. Öffnen Sie den Konverter. Fügen Sie Ihr JSON in das Eingabefeld ein, wählen Sie Ihre .json-Datei über den Datei-Button oder ziehen Sie die Datei per Drag-and-drop hinein. Es wird nichts hochgeladen.
2. Richtung JSON zu INI wählen. Stellen Sie den Richtungs-Umschalter oben auf JSON zu INI. Eingabe ist nun JSON, Ausgabe INI.
3. Optionen einstellen. Legen Sie fest, ob verschachtelte Objekte als Punkt-Sektionen [a.b] geschrieben werden und ob null-Werte weggelassen oder als leerer Wert ausgegeben werden.
4. INI kopieren oder herunterladen. Das Ergebnis erscheint sofort in der Live-Vorschau. Klicken Sie auf Kopieren oder laden Sie das Ergebnis als .ini-Datei herunter.

Ist das JSON ungültig (etwa ein fehlendes Komma oder eine offene Klammer), zeigt das Tool eine freundliche Fehlermeldung mit Hinweis statt eines leeren Ergebnisses. Korrigieren Sie das JSON, und die Vorschau aktualisiert sich automatisch.

Beispiel: aus JSON wird INI

Dieses JSON:

{
  "appname": "MeineApp",
  "server": {
    "host": "localhost",
    "port": 8080,
    "debug": true
  },
  "database": {
    "name": "produktion",
    "timeout": 30
  }
}

wird zu diesem INI:

appname=MeineApp

[server]
host=localhost
port=8080
debug=true

[database]
name=produktion
timeout=30

Beachten Sie: Der Top-Level-Wert appname landet als key=value-Zeile ganz oben, noch vor allen Sektionen. Die Objekte server und database werden zu [server] und [database]. Datentypen wie Zahl und Boolean werden als ihr Text geschrieben, denn INI speichert ohnehin alles als Text.

Wie JSON-Strukturen auf INI abgebildet werden

Diese klaren Regeln machen das Ergebnis vorhersehbar. Für typische Konfigurations-JSONs, also Top-Level-Werte plus eine Handvoll Objekte, ist die Umwandlung sauber und verlustarm.

Warum tiefes JSON nicht immer sauber passt

Hier kommt die ehrliche Einschränkung. JSON kann beliebig tief verschachteln, INI ist im Kern flach: eine Ebene von Sektionen, darunter Schlüssel-Wert-Paare. Die Punktnotation [a.b.c] erweitert das um zusätzliche Ebenen, aber irgendwann ist Schluss. Sobald ein JSON viele Ebenen tief geht, Objekte in Arrays steckt oder Arrays von Objekten enthält, gibt es in INI keine saubere Entsprechung mehr.

Ein Beispiel, das nicht sauber passt:

{
  "server": {
    "endpoints": [
      { "name": "api", "port": 8080 },
      { "name": "web", "port": 80 }
    ]
  }
}

Hier steckt ein Array von Objekten in einem Objekt: eine Struktur, die INI nicht eindeutig abbilden kann. In so einem Fall erzeugt unser Konverter nicht still etwas Falsches, sondern meldet die Grenze klar. So wissen Sie, dass Sie die Struktur vereinfachen müssen, etwa indem Sie die Endpunkte als separate Sektionen anlegen. Wenn Sie regelmäßig komplexe Konfiguration verwalten, ist JSON oder YAML oft die bessere Heimat, was der Ratgeber INI, YAML oder JSON beleuchtet.

null und Arrays in INI behandeln

null-Werte

JSON kennt den Wert null, INI nicht. Das ist keine Kleinigkeit, sondern eine echte Format-Lücke. Unser Konverter bietet daher zwei Wege: Standardmäßig lässt er null-Werte weg, sodass die betroffene Zeile gar nicht erst entsteht. Alternativ können Sie null als leeren Wert schreiben lassen, also key=. Beide Varianten sind bewusste Entscheidungen und nicht vollständig verlustfrei, weil die Information null ist sich in INI nicht von Wert fehlt unterscheiden lässt.

Arrays

Auch Arrays kennt INI nicht als eigenen Typ. Ein JSON-Array wie "tags": ["a", "b", "c"] wird daher als wiederholte Schlüssel ausgegeben:

tags[]=a
tags[]=b
tags[]=c

Diese Schreibweise erhält die Zugehörigkeit zu einem Schlüssel und wird von vielen INI-Parsern als Liste wieder eingelesen. Sehr komplexe Arrays (etwa Arrays von Objekten) lassen sich aber, wie oben gezeigt, nicht sauber abbilden.

Die Wurzel muss ein Objekt sein

Eine wichtige Voraussetzung: Das JSON muss auf oberster Ebene ein Objekt sein, also mit einer geschweiften Klammer beginnen. INI braucht oben Schlüssel-Wert-Paare oder Sektionen, daher lässt sich ein JSON, dessen Wurzel ein Array ([1, 2, 3]) oder ein einzelner Wert ("text" oder 42) ist, nicht sinnvoll als INI abbilden.

Bekommen Sie eine entsprechende Meldung, packen Sie Ihre Daten in ein umschließendes Objekt mit einem benannten Schlüssel, zum Beispiel:

// statt
[1, 2, 3]

// besser
{ "werte": [1, 2, 3] }

Daraus entsteht dann ein sauberes werte[]=1 und so weiter. So umgehen Sie die Wurzel-Beschränkung, ohne dass Informationen verloren gehen.

Häufige Fehler und wie Sie sie lösen

• Ungültiges JSON. Ein fehlendes Komma oder eine offene Klammer bricht das Parsen. Das Tool nennt die Fehlerstelle. Prüfen Sie Klammern, Kommata und Anführungszeichen.
• Wurzel ist ein Array. Packen Sie das Array in ein Objekt mit einem Schlüssel, wie oben gezeigt.
• Tiefe Struktur wird gemeldet. Vereinfachen Sie die Verschachtelung oder erwägen Sie, bei dieser Struktur ganz bei JSON zu bleiben.
• null verschwindet ungewollt. Stellen Sie die Option so ein, dass null als leerer Wert geschrieben wird, falls Sie die Zeile behalten möchten.
• Umlaute im Ergebnis. Speichern Sie die heruntergeladene INI als UTF-8, damit ä, ö, ü und ß korrekt bleiben.

Häufige Fragen

Quellen und Methodik

Die Schritte und Beispiele wurden mit dem Konverter von ini-json.de getestet. Die INI-Beispiele entsprechen der tatsächlichen Ausgabe bei den genannten Optionen. Da INI kein streng standardisiertes Format ist und JSON Strukturen erlaubt, die INI nicht kennt (tiefe Verschachtelung, Arrays von Objekten, null), beschreibt der Artikel offen, was sauber gelingt und wo das Tool eine Grenze meldet. Geprüft am 25.06.2026.