Konwerter JSON na .env

Czym jest plik .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"

Kluczowe funkcje

Przykłady

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

Jak używać

1. 1

   Wklej swój obiekt JSON

   Wprowadź lub wklej płaski obiekt JSON do pola wejściowego powyżej. Możesz też kliknąć „Wczytaj przykład”, aby wypróbować obiekt konfiguracji, wartości wymagające cudzysłowów lub zagnieżdżony obiekt.

2. 2

   Zobacz wynik .env na żywo

   Plik .env pojawia się natychmiast w panelu wynikowym. Przełącz „Normalizuj klucze”, aby uzyskać nazwy UPPER_SNAKE_CASE, lub „Dodaj prefiks export”, jeśli plik będzie ładowany przez source w powłoce.

3. 3

   Kopiuj lub pobierz

   Kliknij Kopiuj, aby pobrać .env do schowka, lub Pobierz, aby zapisać go jako plik .env — gotowy do wrzucenia do projektu i załadowania przez dotenv.

Częste pułapki 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"}

Typowe zastosowania

Generowanie .env z eksportu konfiguracji

Weź eksport konfiguracji JSON z API, panelu ustawień lub menedżera sekretów i zamień go w gotowy do użycia plik .env dla lokalnego środowiska deweloperskiego lub kontenera.

Tworzenie szablonów .env

Zbuduj obiekt JSON opisujący zmienne, których potrzebuje nowa usługa, przekonwertuj go na .env i zatwierdź .env.example, aby koledzy z zespołu wiedzieli dokładnie, które klucze wypełnić.

Pomost między narzędziami konfigurowanymi JSON a dotenv

Niektóre narzędzia emitują konfigurację jako JSON, podczas gdy Twoje środowisko uruchomieniowe oczekuje .env. Przekonwertuj wynik JSON na format dotenv, aby obie połowy potoku zgadzały się co do tych samych zmiennych.

Tworzenie ładowalnych plików env powłoki

Włącz prefiks export, aby wygenerować plik, który możesz załadować bezpośrednio w powłoce lub kroku CI przez source, zamieniając blok konfiguracji JSON w wyeksportowane zmienne środowiskowe w jednym wklejeniu.

Konwersja konfiguracji w obie strony

Połącz to z konwerterem .env na JSON, aby edytować konfigurację jako strukturalny JSON i zapisywać ją z powrotem do .env — cudzysłowanie bezpieczne dla konwersji w obie strony gwarantuje, że wartości przetrwają w obu kierunkach.

Normalizacja kluczy o mieszanej wielkości liter

Przekonwertuj obiekt JSON z kluczami camelCase lub kebab-case na .env ze spójnymi nazwami zmiennych UPPER_SNAKE_CASE za pomocą opcji „Normalizuj klucze”, dopasowując się do konwencji zmiennych środowiskowych.

Szczegóły techniczne

Wejście wyłącznie obiektowe z typowaną serializacją

Dane wejściowe są parsowane natywnym JSON.parse() przeglądarki i muszą być obiektem najwyższego poziomu; tablice i skalary są odrzucane z czytelnym błędem. Każda właściwość najwyższego poziomu jest serializowana według typu: liczby i wartości logiczne są zapisywane gołe, null staje się pustą wartością (KEY=), a ciągi znaków są zapisywane bezpośrednio, chyba że zawierają spację, znak nowej linii, # lub cudzysłów, w którym to przypadku są ujmowane w podwójne cudzysłowy i poprzedzane sekwencjami ucieczki dla bezpieczeństwa konwersji w obie strony.

Wartości zagnieżdżone i normalizacja kluczy

Zagnieżdżone obiekty i tablice są serializowane zwartym JSON.stringify, ujmowane w podwójne cudzysłowy i poprzedzane sekwencjami ucieczki, z ostrzeżeniem wymieniającym spłaszczone klucze. Opcjonalny krok „Normalizuj klucze” konwertuje klucze na UPPER_SNAKE_CASE, rozwiązując większość niepoprawnych nazw; gdy klucze są zachowywane dosłownie, każdy klucz, który nie pasuje do [A-Za-z_][A-Za-z0-9_]*, wyzwala ostrzeżenie o niepoprawnej nazwie. Opcjonalny prefiks export można dodać do każdej linii.

Po stronie przeglądarki — bez wysyłania, bez serwera

Całe przetwarzanie odbywa się w całości w silniku JavaScript Twojej przeglądarki; żadne dane JSON nie są w żadnym momencie przesyłane przez sieć. Serializer jest napisany we własnym zakresie, bez zależności zewnętrznych, ponieważ biblioteka Node dotenv nie jest bezpieczna dla przeglądarki. Dane wejściowe większe niż 200 KB przełączają się z trybu na żywo w tryb ręczny (jawne kliknięcie Konwertuj), aby przeglądarka pozostała responsywna.

Najlepsze praktyki

Zachowaj klucze dosłownie, chyba że potrzebujesz konwencji env

Pozostaw „Normalizuj klucze” wyłączone, gdy aplikacja konsumująca już oczekuje dokładnych nazw kluczy z Twojego JSON, aby nic nie zostało niespodziewanie zmienione. Włączaj je tylko wtedy, gdy konkretnie chcesz konwencji UPPER_SNAKE_CASE, której zmienne środowiskowe zwyczajowo używają.

Spłaszczaj zagnieżdżenie celowo, nie przypadkiem

Zagnieżdżona wartość staje się nieprzejrzystym ciągiem znaków JSON w .env, którego większość aplikacji nie potrafi automatycznie sparsować z powrotem. Gdy zobaczysz ostrzeżenie o spłaszczeniu, zamiast tego przekształć JSON w płaskie, prefiksowane klucze (DB_HOST, DB_PORT) przed konwersją albo wybierz format strukturalny, taki jak YAML.

Zaufaj automatycznemu cudzysłowaniu przy konwersji w obie strony

Pozwól narzędziu zdecydować, kiedy ujmować w cudzysłowy — ujmuje w podwójne cudzysłowy i poprzedza sekwencjami ucieczki tylko te wartości, które tego wymagają. Dzięki temu .env pozostaje czytelny, jednocześnie gwarantując, że wartości ze spacjami, znakami nowej linii lub # przetrwają konwersję w obie strony z powrotem przez konwerter .env na JSON bez zmian.

Generuj sekrety tylko w narzędziu działającym wyłącznie w przeglądarce

JSON, który tu konwertujesz, to w istocie zestaw poświadczeń. Generuj .env tylko w narzędziu, które działa w całości w przeglądarce; zweryfikuj zero żądań sieciowych w DevTools. Ten konwerter się kwalifikuje, w przeciwieństwie do generatorów po stronie serwera lub opartych na API.

Najpierw zweryfikuj wejściowy JSON

Jeśli JSON jest pisany ręcznie lub składany przez skrypt, najpierw zweryfikuj go za pomocą formatera JSON, aby wyłapać końcowe przecinki lub klucze bez cudzysłowów, abyś otrzymał czysty .env zamiast mylącego błędu parsowania.

Najczęściej zadawane pytania