JSON zu .env Konverter

Was ist eine .env-Datei?

// Generate .env lines from a JSON object in Node.js
const config = {
  DATABASE_URL: 'postgres://user:pass@localhost:5432/mydb',
  PORT: 8080,
  DEBUG: true,
  NOTE: 'value with spaces',
};

const needsQuotes = (s) => /[\s#"'\n]/.test(s);

const env = Object.entries(config)
  .map(([key, value]) => {
    if (typeof value === 'string') {
      return needsQuotes(value)
        ? `${key}=${JSON.stringify(value)}`
        : `${key}=${value}`;
    }
    return `${key}=${value ?? ''}`; // null -> empty value
  })
  .join('\n');

console.log(env);
// DATABASE_URL=postgres://user:pass@localhost:5432/mydb
// PORT=8080
// DEBUG=true
// NOTE="value with spaces"

Hauptfunktionen

Beispiele

{
  "DATABASE_URL": "postgres://user:pass@localhost:5432/mydb",
  "PORT": 8080,
  "DEBUG": true,
  "LOG_LEVEL": "info",
  "API_KEY": "sk_live_abc123"
}

DATABASE_URL=postgres://user:pass@localhost:5432/mydb
PORT=8080
DEBUG=true
LOG_LEVEL=info
API_KEY=sk_live_abc123

{
  "GREETING": "Hello, World",
  "MOTD": "line one\nline two",
  "COLOR": "#ff0000",
  "NOTE": "value with # hash",
  "EMPTY": null
}

GREETING="Hello, World"
MOTD="line one\nline two"
COLOR="#ff0000"
NOTE="value with # hash"
EMPTY=

{
  "databaseUrl": "postgres://localhost/mydb",
  "poolSize": 10,
  "enable-signup": true
}

DATABASE_URL=postgres://localhost/mydb
POOL_SIZE=10
ENABLE_SIGNUP=true

{
  "APP_NAME": "my-app",
  "FEATURES": { "signup": true, "beta": false },
  "REGIONS": ["us-east-1", "eu-west-1"]
}

APP_NAME=my-app
FEATURES="{\"signup\":true,\"beta\":false}"
REGIONS="[\"us-east-1\",\"eu-west-1\"]"

Anwendung

1. 1

   Füge dein JSON-Objekt ein

   Gib ein flaches JSON-Objekt in das Eingabefeld oben ein oder füge es ein. Du kannst auch auf 'Beispiel laden' klicken, um ein Konfigurationsobjekt, Werte, die Anführungszeichen benötigen, oder ein verschachteltes Objekt auszuprobieren.

2. 2

   Live-.env-Ausgabe ansehen

   Die .env-Datei erscheint sofort im Ausgabe-Panel. Schalte 'Schlüssel normalisieren' für UPPER_SNAKE_CASE-Namen um, oder 'export-Präfix hinzufügen', wenn die Datei in einer Shell per source eingelesen wird.

3. 3

   Kopieren oder Herunterladen

   Klicke auf Kopieren, um die .env in die Zwischenablage zu übernehmen, oder auf Herunterladen, um sie als .env-Datei zu speichern — bereit, in dein Projekt eingefügt und mit dotenv geladen zu werden.

Häufige JSON-Fallstricke

["a", "b", "c"]

{"ITEMS": "a,b,c"}

{'PORT': 8080,}

{"PORT": 8080}

{"DB": {"host": "localhost", "port": 5432}}

{"DB_HOST": "localhost", "DB_PORT": 5432}

{"2fa-enabled": true}

{"TWO_FA_ENABLED": true}

{"MSG": Hello World}

{"MSG": "Hello World"}

Häufige Anwendungsfälle

.env aus einem Konfigurationsexport erzeugen

Nimm einen JSON-Konfigurationsexport aus einer API, einem Einstellungs-Dashboard oder einem Secrets-Manager und verwandle ihn in eine einsatzbereite .env-Datei für die lokale Entwicklung oder einen Container.

.env-Vorlagen aufbauen

Baue ein JSON-Objekt, das die Variablen beschreibt, die ein neuer Dienst braucht, konvertiere es zu einer .env und committe eine .env.example, damit Teamkollegen genau wissen, welche Schlüssel auszufüllen sind.

JSON-konfigurierte Tools mit dotenv verbinden

Manche Tools geben Konfiguration als JSON aus, während deine Laufzeit eine .env erwartet. Konvertiere die JSON-Ausgabe in das dotenv-Format, damit beide Hälften der Pipeline sich auf dieselben Variablen einigen.

Per source einlesbare Shell-env-Dateien erzeugen

Aktiviere das export-Präfix, um eine Datei zu erzeugen, die du direkt in einer Shell oder einem CI-Schritt per source einlesen kannst, und verwandle einen JSON-Konfigurations-Blob in einem Einfügen in exportierte Umgebungsvariablen.

Konfiguration im Roundtrip

Kombiniere dies mit dem .env zu JSON Konverter, um Konfiguration als strukturiertes JSON zu bearbeiten und wieder in eine .env zu schreiben — das roundtrip-sichere Zitieren garantiert, dass Werte beide Richtungen überstehen.

Schlüssel mit gemischter Groß-/Kleinschreibung normalisieren

Konvertiere ein JSON-Objekt mit camelCase- oder kebab-case-Schlüsseln in eine .env mit konsistenten UPPER_SNAKE_CASE-Variablennamen mithilfe der Option Schlüssel normalisieren, passend zu den Umgebungsvariablen-Konventionen.

Technische Details

Nur Objekt-Eingabe mit typisierter Serialisierung

Die Eingabe wird mit dem nativen JSON.parse() des Browsers geparst und muss ein Objekt auf oberster Ebene sein; Arrays und Skalare werden mit einem klaren Fehler abgelehnt. Jede Eigenschaft der obersten Ebene wird nach Typ serialisiert: Zahlen und Booleans werden nackt geschrieben, null wird zu einem leeren Wert (KEY=), und Strings werden direkt geschrieben, es sei denn, sie enthalten ein Leerzeichen, einen Zeilenumbruch, # oder ein Anführungszeichen, in welchem Fall sie für die Roundtrip-Sicherheit in doppelte Anführungszeichen gesetzt und maskiert werden.

Verschachtelte Werte und Schlüsselnormalisierung

Verschachtelte Objekte und Arrays werden mit einem kompakten JSON.stringify serialisiert, in doppelte Anführungszeichen gesetzt und maskiert, mit einer Warnung, die die abgeflachten Schlüssel benennt. Der optionale Schritt Schlüssel normalisieren wandelt Schlüssel in UPPER_SNAKE_CASE um und löst die meisten ungültigen Namen auf; werden Schlüssel wörtlich beibehalten, löst jeder Schlüssel, der nicht [A-Za-z_][A-Za-z0-9_]* entspricht, eine Warnung über einen ungültigen Namen aus. Ein optionales export-Präfix kann jeder Zeile hinzugefügt werden.

Browserbasiert — kein Upload, kein Server

Die gesamte Verarbeitung geschieht vollständig in der JavaScript-Engine deines Browsers; zu keinem Zeitpunkt werden JSON-Daten über das Netzwerk übertragen. Der Serializer ist hauseigen ohne externe Abhängigkeiten geschrieben, da die Node-dotenv-Bibliothek nicht browsersicher ist. Eingaben größer als 200KB wechseln vom Live-Modus in den manuellen Modus (ein expliziter Konvertieren-Klick), damit der Browser reaktionsfähig bleibt.

Bewährte Praktiken

Behalte Schlüssel wörtlich, sofern du keine env-Konventionen brauchst

Lasse Schlüssel normalisieren deaktiviert, wenn die konsumierende App bereits die exakten Schlüsselnamen in deinem JSON erwartet, damit nichts unerwartet umbenannt wird. Aktiviere es nur, wenn du gezielt die UPPER_SNAKE_CASE-Konvention möchtest, die Umgebungsvariablen üblicherweise verwenden.

Verschachtelung absichtlich abflachen, nicht versehentlich

Ein verschachtelter Wert wird in der .env zu einem opaken JSON-String, den die meisten Apps nicht automatisch zurückparsen können. Wenn du die Abflachungs-Warnung siehst, forme das JSON lieber vor dem Konvertieren in flache, präfigierte Schlüssel um (DB_HOST, DB_PORT), oder wähle ein strukturiertes Format wie YAML.

Vertraue dem Auto-Zitieren für Roundtrips

Lass das Tool entscheiden, wann zitiert wird — es setzt nur die Werte in doppelte Anführungszeichen und maskiert sie, die es benötigen. Das hält die .env lesbar und garantiert zugleich, dass Werte mit Leerzeichen, Zeilenumbrüchen oder # einen Roundtrip zurück durch den .env zu JSON Konverter unverändert überstehen.

Geheimnisse nur in einem reinen Browser-Tool erzeugen

Das JSON, das du hier konvertierst, ist faktisch eine Menge von Zugangsdaten. Erzeuge eine .env nur in einem Tool, das vollständig im Browser läuft; überprüfe null Netzwerkanfragen in den DevTools. Dieser Konverter qualifiziert sich, anders als serverseitige oder API-gestützte Generatoren.

Validiere zuerst die JSON-Eingabe

Wenn das JSON von Hand geschrieben oder von einem Skript zusammengesetzt ist, validiere es zuerst mit dem JSON-Formatierer, um nachgestellte Kommata oder nicht zitierte Schlüssel abzufangen, damit du eine saubere .env statt eines verwirrenden Parse-Fehlers erhältst.

Häufig gestellte Fragen