Convertitore da .env a JSON

Cos'è un file .env?

// Parse a .env file to a JSON object in Node.js using dotenv
import { parse } from 'dotenv';

const envText = `# Database
DATABASE_URL=postgres://user:pass@localhost:5432/mydb
DEBUG=true`;

// dotenv.parse returns a plain object of string values
const parsed = parse(envText);

// Every value is a string, just like process.env
const json = JSON.stringify(parsed, null, 2);

console.log(json);
// {
//   "DATABASE_URL": "postgres://user:pass@localhost:5432/mydb",
//   "DEBUG": "true"
// }

Caratteristiche principali

Esempi

# Database
DATABASE_URL=postgres://user:pass@localhost:5432/mydb
DATABASE_POOL_SIZE=10

# Auth
JWT_SECRET="super secret value"
SESSION_TIMEOUT=3600

# Feature flags
ENABLE_SIGNUP=true
VITE_API_BASE=https://api.example.com

{
  "DATABASE_URL": "postgres://user:pass@localhost:5432/mydb",
  "DATABASE_POOL_SIZE": "10",
  "JWT_SECRET": "super secret value",
  "SESSION_TIMEOUT": "3600",
  "ENABLE_SIGNUP": "true",
  "VITE_API_BASE": "https://api.example.com"
}

POSTGRES_DB=mydb
POSTGRES_USER=admin
POSTGRES_PASSWORD=s3cr3t!
PGDATA=/var/lib/postgresql/data
TZ=UTC
NGINX_HOST=example.com
NGINX_PORT=80

{
  "POSTGRES_DB": "mydb",
  "POSTGRES_USER": "admin",
  "POSTGRES_PASSWORD": "s3cr3t!",
  "PGDATA": "/var/lib/postgresql/data",
  "TZ": "UTC",
  "NGINX_HOST": "example.com",
  "NGINX_PORT": "80"
}

export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
export AWS_REGION=us-east-1
export DEPLOY_ENV=production

{
  "AWS_ACCESS_KEY_ID": "AKIAIOSFODNN7EXAMPLE",
  "AWS_SECRET_ACCESS_KEY": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
  "AWS_REGION": "us-east-1",
  "DEPLOY_ENV": "production"
}

APP_NAME=My App                 # unquoted value, inline comment stripped
GREETING="Hello,\nWorld"        # double quotes: \n becomes a real newline
LITERAL='no \n escapes here'    # single quotes: kept literally
PRIVATE_KEY="-----BEGIN KEY-----
line two
line three
-----END KEY-----"
EMPTY=

{
  "APP_NAME": "My App",
  "GREETING": "Hello,\nWorld",
  "LITERAL": "no \\n escapes here",
  "PRIVATE_KEY": "-----BEGIN KEY-----\nline two\nline three\n-----END KEY-----",
  "EMPTY": ""
}

Come si usa

1. 1

   Incolla il tuo file .env

   Inserisci o incolla il contenuto del tuo .env nel campo di input qui sopra. Puoi anche cliccare 'Carica esempio' per provare un .env Node/Vite, un file env Docker Compose o un modello di segreti CI.

2. 2

   Vedi l'output JSON dal vivo

   Il JSON appare all'istante nel pannello di output. Attiva 'Inferisci i tipi' se vuoi numeri e booleani al posto delle stringhe, e scegli un'indentazione di 2 o 4 spazi.

3. 3

   Copia o scarica

   Clicca Copia per ottenere il JSON negli appunti, oppure Scarica per salvarlo come file .json, pronto per un caricatore di configurazione, un gestore di segreti o qualsiasi strumento che legge JSON.

Insidie comuni dei file .env

DATABASE_URL
DEBUG true

DATABASE_URL=
DEBUG=true

API_KEY = abc123

API_KEY=abc123

COLOR=#ff0000

COLOR="#ff0000"

GREETING='Hello\nWorld'

GREETING="Hello\nWorld"

KEY="-----BEGIN-----
line two

KEY="-----BEGIN-----
line two
-----END-----"

PORT=3000
PORT=8080

PORT=8080

Casi d'uso comuni

Fornire la configurazione a strumenti basati su JSON

Converti un file .env in JSON per caricare la configurazione d'ambiente in strumenti, script e SDK che leggono JSON anziché variabili d'ambiente: validatori di configurazione, controllori di schema e generatori di codice.

Importare segreti in un gestore

Molti gestori di segreti (AWS Secrets Manager, Vault, Doppler) accettano JSON per l'importazione in blocco. Converti prima un file .env in un oggetto JSON, poi carica l'intero insieme in un'unica operazione invece di una variabile alla volta.

Esaminare un lungo .env a colpo d'occhio

Trasforma un .env esteso in JSON strutturato e indentato così da scorrere le chiavi, individuare i duplicati tramite l'avviso ed esaminare la configurazione in un formato leggibile prima di confermare le modifiche.

Generare oggetti di configurazione tipizzati

Abilita Inferisci i tipi per ottenere numeri, booleani e null nel JSON, poi forniscilo a un livello di configurazione tipizzato o a un passaggio da JSON a TypeScript per derivare un'interfaccia per le tue variabili d'ambiente.

Validare rispetto a un JSON Schema

Converti .env in JSON ed eseguilo attraverso un validatore JSON Schema per imporre chiavi obbligatorie, formati dei valori ed enum consentiti in CI, intercettando ambienti mal configurati prima del deploy.

Migrare la configurazione env_file di Docker Compose

Trasforma in JSON l'env_file che il tuo stack Compose legge per usarlo in un altro strumento di orchestrazione, un server di configurazione o la documentazione, senza esporre credenziali reali ad alcun servizio esterno.

Dettagli tecnici

Analisi riga per riga compatibile con dotenv

L'input viene analizzato riga per riga. Le righe vuote e le righe di commento (primo carattere non vuoto #) vengono ignorate, un prefisso opzionale export viene rimosso e ogni riga restante viene separata al primo = in chiave e valore. Alle chiavi vengono rimossi gli spazi circostanti. I valori seguono le regole dotenv: le virgolette doppie elaborano gli escape \n \t \r \\ \" e consentono estensioni multi-riga, le virgolette singole sono letterali e i valori non racchiusi tra virgolette rimuovono gli spazi finali e i commenti inline.

Inferenza dei tipi opzionale

Per impostazione predefinita tutti i valori vengono emessi come stringhe JSON, in corrispondenza con il comportamento di dotenv in fase di esecuzione dove i valori di process.env sono sempre stringhe. Con Inferisci i tipi abilitato, i valori non racchiusi tra virgolette vengono promossi: le stringhe numeriche diventano numeri JSON, true/false diventano booleani e i valori vuoti o null diventano null JSON. I valori tra virgolette non vengono mai inferiti: le virgolette li marcano come stringhe esplicite. Le chiavi duplicate si risolvono con la regola dell'ultima che vince e un avviso.

Basato sul browser — nessun upload, nessun server

Tutta l'elaborazione avviene interamente nel motore JavaScript del tuo browser; nessun dato del .env viene trasmesso in rete in alcun momento. Non ci sono dipendenze esterne perché il parser è scritto internamente: la libreria Node dotenv si appoggia al file system e 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 l'output stringa predefinito per corrispondere a dotenv

dotenv carica ogni valore come stringa, quindi l'output stringa predefinito riflette esattamente ciò che la tua applicazione vede in fase di esecuzione. Abilita Inferisci i tipi solo quando il consumatore a valle si aspetta davvero un JSON tipizzato, altrimenti rischi una discrepanza in cui '0' o 'false' si comporta in modo diverso nel JSON rispetto all'app in esecuzione.

Racchiudi tra virgolette i valori che contengono # o spazi

Sui valori non racchiusi tra virgolette uno spazio seguito da # avvia un commento inline, e gli spazi finali vengono rimossi. Se un valore contiene legittimamente un # (colori esadecimali, URL con frammento) o spazi significativi, racchiudilo tra virgolette doppie così che venga preservato alla lettera nel JSON.

Risolvi le chiavi duplicate alla fonte

Lo strumento mantiene l'ultimo valore e ti avvisa quando una chiave è duplicata, ma un duplicato in un file .env è quasi sempre un errore. Rimuovi la riga ridondante così che non ci sia ambiguità su quale segreto sia attivo.

Non incollare mai segreti di produzione in convertitori lato server

Poiché un file .env è di fatto un elenco di credenziali, convertilo solo in uno strumento che gira interamente nel browser. Questo convertitore lo fa — verifica zero richieste di rete nei DevTools — quindi è sicuro per segreti reali, a differenza dei convertitori lato server o basati su API.

Valida il JSON prima di usarlo a valle

Dopo la conversione, esegui il JSON attraverso il Formattatore JSON per confermare la struttura prima di fornirlo a un validatore di schema, a un'importazione di gestore di segreti o a un caricatore di configurazione, così che una sorpresa strutturale emerga subito.

Domande frequenti