Convertitore da JSON a .env

Cos'è un file .env?

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

Caratteristiche principali

Esempi

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

Come si usa

1. 1

   Incolla il tuo oggetto JSON

   Inserisci o incolla un oggetto JSON piatto nel campo di input qui sopra. Puoi anche cliccare 'Carica esempio' per provare un oggetto di configurazione, valori che richiedono le virgolette o un oggetto annidato.

2. 2

   Vedi l'output .env dal vivo

   Il file .env appare all'istante nel pannello di output. Attiva 'Normalizza le chiavi' per nomi in UPPER_SNAKE_CASE, oppure 'Aggiungi prefisso export' se il file verrà caricato con source in una shell.

3. 3

   Copia o scarica

   Clicca Copia per ottenere il .env negli appunti, oppure Scarica per salvarlo come file .env, pronto da inserire nel tuo progetto e caricare con dotenv.

Insidie comuni del JSON

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

Casi d'uso comuni

Generare un .env da un'esportazione di configurazione

Prendi un'esportazione di configurazione JSON da un'API, una dashboard di impostazioni o un gestore di segreti e trasformala in un file .env pronto all'uso per lo sviluppo locale o un container.

Creare modelli .env

Costruisci un oggetto JSON che descrive le variabili di cui un nuovo servizio ha bisogno, convertilo in un .env e committa un .env.example così che i compagni di squadra sappiano esattamente quali chiavi compilare.

Collegare strumenti configurati in JSON a dotenv

Alcuni strumenti emettono la configurazione come JSON mentre il tuo runtime si aspetta un .env. Converti l'output JSON nel formato dotenv così che entrambe le metà della pipeline concordino sulle stesse variabili.

Produrre file env shell caricabili con source

Abilita il prefisso export per generare un file che puoi caricare direttamente con source in una shell o in un passaggio CI, trasformando un blob di configurazione JSON in variabili d'ambiente esportate in un solo incolla.

Configurazione round-trip

Abbinalo al Convertitore da .env a JSON per modificare la configurazione come JSON strutturato e riscriverla in .env: le virgolette sicure per il round-trip garantiscono che i valori sopravvivano in entrambe le direzioni.

Normalizzare chiavi con maiuscole/minuscole miste

Converti un oggetto JSON con chiavi in camelCase o kebab-case in un .env con nomi di variabili coerenti in UPPER_SNAKE_CASE usando l'opzione Normalizza le chiavi, in linea con le convenzioni delle variabili d'ambiente.

Dettagli tecnici

Input solo oggetto con serializzazione tipizzata

L'input viene analizzato con il JSON.parse() nativo del browser e deve essere un oggetto di primo livello; array e scalari vengono rifiutati con un errore chiaro. Ogni proprietà di primo livello viene serializzata per tipo: numeri e booleani vengono scritti nudi, null diventa un valore vuoto (CHIAVE=), e le stringhe vengono scritte direttamente a meno che non contengano uno spazio, un a capo, un # o una virgoletta, nel qual caso vengono racchiuse tra virgolette doppie e sottoposte a escape per la sicurezza del round-trip.

Valori annidati e normalizzazione delle chiavi

Oggetti e array annidati vengono serializzati con un JSON.stringify compatto, racchiusi tra virgolette doppie e sottoposti a escape, con un avviso che nomina le chiavi appiattite. Il passaggio opzionale Normalizza le chiavi converte le chiavi in UPPER_SNAKE_CASE, risolvendo la maggior parte dei nomi non validi; quando le chiavi vengono mantenute alla lettera, qualsiasi chiave che non corrisponda a [A-Za-z_][A-Za-z0-9_]* attiva un avviso di nome non valido. Un prefisso export opzionale può essere aggiunto a ogni riga.

Basato sul browser — nessun upload, nessun server

Tutta l'elaborazione avviene interamente nel motore JavaScript del tuo browser; nessun dato JSON viene trasmesso in rete in alcun momento. Il serializzatore è scritto internamente senza dipendenze esterne, dato che la libreria Node dotenv non è sicura per il browser. Gli input più grandi di 200 KB passano dalla modalità dal vivo alla modalità manuale (un clic esplicito su Converti) per mantenere reattivo il browser.

Buone pratiche

Mantieni le chiavi alla lettera a meno che non ti servano le convenzioni env

Lascia Normalizza le chiavi disattivato quando l'app consumatrice si aspetta già i nomi di chiave esatti nel tuo JSON, così niente viene rinominato inaspettatamente. Attivalo solo quando vuoi specificamente la convenzione UPPER_SNAKE_CASE usata convenzionalmente dalle variabili d'ambiente.

Appiattisci l'annidamento di proposito, non per caso

Un valore annidato diventa una stringa JSON opaca nel .env, che la maggior parte delle app non può analizzare di nuovo automaticamente. Quando vedi l'avviso di appiattimento, preferisci rimodellare il JSON in chiavi piatte e con prefisso (DB_HOST, DB_PORT) prima di convertire, oppure scegli un formato strutturato come YAML.

Affidati alle virgolette automatiche per i round-trip

Lascia che sia lo strumento a decidere quando racchiudere tra virgolette: racchiude tra virgolette doppie e sottopone a escape solo i valori che ne hanno bisogno. Questo mantiene il .env leggibile garantendo al contempo che i valori con spazi, a capo o # sopravvivano immutati a un round-trip attraverso il Convertitore da .env a JSON.

Genera segreti solo in uno strumento esclusivamente lato browser

Il JSON che converti qui è di fatto un insieme di credenziali. Genera un .env solo in uno strumento che gira interamente nel browser; verifica zero richieste di rete nei DevTools. Questo convertitore lo soddisfa, a differenza dei generatori lato server o basati su API.

Valida prima l'input JSON

Se il JSON è scritto a mano o assemblato da uno script, validalo prima con il Formattatore JSON per intercettare virgole finali o chiavi non racchiuse tra virgolette, così ottieni un .env pulito invece di un confuso errore di analisi.

Domande frequenti