JSON naar .env Converter

Wat is een .env-bestand?

// 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"

Belangrijkste functies

Voorbeelden

{
  "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\"]"

Hoe te gebruiken

1. 1

   Plak je JSON-object

   Voer een plat JSON-object in of plak het in het invoerveld hierboven. Je kunt ook op 'Voorbeeld laden' klikken om een config-object, waarden die aanhalingstekens nodig hebben, of een genest object te proberen.

2. 2

   Bekijk live .env-uitvoer

   Het .env-bestand verschijnt direct in het uitvoerpaneel. Schakel 'Sleutels normaliseren' in voor UPPER_SNAKE_CASE-namen, of 'export-prefix toevoegen' als het bestand in een shell gesourcet wordt.

3. 3

   Kopiëren of downloaden

   Klik op Kopiëren om de .env naar je klembord te halen, of op Downloaden om het als .env-bestand op te slaan — klaar om in je project te zetten en met dotenv te laden.

Veelvoorkomende JSON-valkuilen

["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"}

Veelvoorkomende toepassingen

.env genereren uit een config-export

Neem een JSON-configuratie-export van een API, een instellingen-dashboard of een secrets manager en zet die om in een kant-en-klaar .env-bestand voor lokale ontwikkeling of een container.

.env-sjablonen opzetten

Bouw een JSON-object dat de variabelen beschrijft die een nieuwe service nodig heeft, converteer het naar een .env, en commit een .env.example zodat teamgenoten precies weten welke sleutels ze moeten invullen.

JSON-geconfigureerde tools koppelen aan dotenv

Sommige tools geven configuratie als JSON uit terwijl je runtime een .env verwacht. Converteer de JSON-uitvoer naar dotenv-formaat zodat beide helften van de pipeline het eens zijn over dezelfde variabelen.

Sourcebare shell-env-bestanden produceren

Schakel het export-prefix in om een bestand te genereren dat je direct in een shell of CI-stap kunt sourcen, waarbij een JSON-config-blob in één keer plakken wordt omgezet in geëxporteerde omgevingsvariabelen.

Configuratie round-trippen

Combineer dit met de .env naar JSON Converter om configuratie als gestructureerde JSON te bewerken en terug naar .env te schrijven — de round-trip-veilige aanhalingstekens garanderen dat waarden beide richtingen overleven.

Sleutels met gemengde naamgeving normaliseren

Zet een JSON-object met camelCase- of kebab-case-sleutels om naar een .env met consistente UPPER_SNAKE_CASE-variabelenamen via de optie Sleutels normaliseren, passend bij de conventies voor omgevingsvariabelen.

Technische details

Alleen-object-invoer met getypeerde serialisatie

Invoer wordt geparseerd met de native JSON.parse() van de browser en moet een object op het hoogste niveau zijn; arrays en scalars worden met een duidelijke fout afgewezen. Elke eigenschap op het hoogste niveau wordt op type geserialiseerd: getallen en booleans worden kaal geschreven, null wordt een lege waarde (KEY=), en strings worden direct geschreven tenzij ze een spatie, nieuwe regel, # of aanhalingsteken bevatten, in welk geval ze tussen dubbele aanhalingstekens worden gezet en geëscaped voor round-trip-veiligheid.

Geneste waarden en sleutelnormalisatie

Geneste objecten en arrays worden geserialiseerd met een compacte JSON.stringify, tussen dubbele aanhalingstekens gezet en geëscaped, met een waarschuwing die de afgevlakte sleutels benoemt. De optionele stap Sleutels normaliseren zet sleutels om naar UPPER_SNAKE_CASE en lost de meeste ongeldige namen op; wanneer sleutels letterlijk worden behouden, veroorzaakt elke sleutel die niet overeenkomt met [A-Za-z_][A-Za-z0-9_]* een waarschuwing voor een ongeldige naam. Een optioneel export-prefix kan aan elke regel worden toegevoegd.

Browsergebaseerd — geen upload, geen server

Alle verwerking gebeurt volledig in de JavaScript-engine van je browser; er worden op geen enkel moment JSON-gegevens over het netwerk verzonden. De serializer is in eigen huis geschreven zonder externe afhankelijkheden, aangezien de Node-dotenv-bibliotheek niet browserveilig is. Invoer groter dan 200KB schakelt over van live-modus naar handmatige modus (een expliciete Converteren-klik) om de browser responsief te houden.

Best practices

Behoud sleutels letterlijk tenzij je env-conventies nodig hebt

Laat Sleutels normaliseren uit wanneer de consumerende app al de exacte sleutelnamen in je JSON verwacht, zodat er niets onverwacht wordt hernoemd. Zet het alleen aan wanneer je specifiek de UPPER_SNAKE_CASE-conventie wilt die omgevingsvariabelen conventioneel gebruiken.

Vlak nesting bewust af, niet per ongeluk

Een geneste waarde wordt een ondoorzichtige JSON-string in de .env, die de meeste apps niet automatisch terug kunnen parseren. Wanneer je de afvlakkingswaarschuwing ziet, herstructureer de JSON dan liever naar platte, geprefixte sleutels (DB_HOST, DB_PORT) vóór het converteren, of kies een gestructureerd formaat als YAML.

Vertrouw op de automatische aanhalingstekens voor round-trips

Laat de tool beslissen wanneer er aanhalingstekens nodig zijn — die zet alleen de waarden die het nodig hebben tussen dubbele aanhalingstekens en escapet ze. Dit houdt de .env leesbaar en garandeert dat waarden met spaties, nieuwe regels of # een round-trip terug door de .env naar JSON Converter ongewijzigd overleven.

Genereer geheimen alleen in een browser-only tool

De JSON die je hier converteert is in feite een set inloggegevens. Genereer een .env alleen in een tool die volledig in de browser draait; verifieer nul netwerkverzoeken in DevTools. Deze converter kwalificeert daarvoor, anders dan server-side of API-gebaseerde generatoren.

Valideer eerst de JSON-invoer

Als de JSON met de hand is geschreven of door een script is samengesteld, valideer die dan eerst met de JSON Formatter om trailing komma's of niet-aangehaalde sleutels op te vangen, zodat je een schone .env krijgt in plaats van een verwarrende parse-fout.

Veelgestelde vragen