So funktioniert die Umwandlung von JSON in .env
Eine .env-Datei ist eine flache Liste von KEY=value-Zeilen, JSON dagegen kann Objekte beliebig tief verschachteln. Der Konverter geht das Objekt durch und erzeugt pro Endwert eine Variable. Jede Ebene tiefer hängt den Schlüssel und einen Unterstrich an den Namen an.
- Flach machen:
{"stripe": {"webhook": {"secret": "whsec_…"}}}wird zum Pfadstripe_webhook_secret. - Namen normalisieren: Der Pfad wird großgeschrieben und jedes Zeichen außer
A-Z,0-9und_wird zu_, ausallowed-originswird alsoALLOWED_ORIGINS. - Wert schreiben: Strings und Zahlen werden übernommen,
nullwird zu einem leeren Wert, Arrays werden zu einem JSON-String. - Bei Bedarf quoten: Ein Wert mit Leerzeichen,
#, Anführungszeichen,$, Backslash oder Zeilenumbruch kommt in doppelte Anführungszeichen; innere doppelte Anführungszeichen werden escaped.
Du brauchst die Gegenrichtung? Der ENV-zu-JSON-Konverter macht aus einer .env wieder ein Objekt und kann "true" und "3000" zurück in echte Booleans und Zahlen umwandeln.
Was sich ändert, wenn JSON zur .env-Datei wird
| JSON-Eingabe | .env-Ausgabe | Was deine App bekommt |
|---|---|---|
"port": 3000 | PORT=3000 | den String "3000" |
"debug": true | DEBUG=true | den String "true" (wahr, selbst wenn dort "false" steht) |
"tags": ["a","b"] | TAGS="[\"a\",\"b\"]" | einen JSON-String, mit JSON.parse lesen |
"dsn": null | DSN= | einen leeren String, bei manchen Loadern undefined |
"db": {"url": "…"} | DB_URL=… | eine flache Variable pro Endwert |
Am sichersten ist es, einmal beim Start zu validieren und umzuwandeln, zum Beispiel mit zod in Node.js oder pydantic-settings in Python, statt überall im Code Number() aufzurufen. Der .env-Validator findet fehlerhafte Zeilen, bevor es deine App tut.
JSON auf der Kommandozeile in .env umwandeln
Für ein flaches JSON-Objekt ohne Verschachtelung erledigt jq das in CI-Pipelines:
# flat object only: {"PORT": 3000, "NODE_ENV": "production"}
jq -r 'to_entries[] | "\(.key)=\(.value)"' config.json > .env
# AWS Secrets Manager (SecretString is a JSON object)
aws secretsmanager get-secret-value --secret-id prod/app \
--query SecretString --output text \
| jq -r 'to_entries[] | "\(.key)=\(.value)"' > .envDiese Einzeiler machen verschachtelte Objekte nicht flach und setzen Werte mit # oder Leerzeichen nicht in Anführungszeichen. Für alles Verschachtelte oder mit Passwörtern füge das JSON oben in den Konverter ein und schick das Ergebnis danach durch den .env-Formatter, wenn du es ausgerichtet und sortiert haben möchtest.