Zum Inhalt springen
uencoder

dotenv

dotenv ist die Bibliothek und Konvention, die .env-Dateien in Umgebungsvariablen lädt; sie ist die beliebteste im Node.js-Ökosystem und externalisiert die Konfiguration.

Zweck

Der lokalen Entwicklung die Konfiguration per .env-Datei erlauben, während die Produktion echte Umgebungsvariablen nutzt – ganz ohne Codeänderung.

Mechanismus

Beim Start liest sie die .env-Datei, parst KEY=VALUE-Zeilen und injiziert sie in process.env. Sie unterstützt mehrere Umgebungen (.env.development), Variableninterpolation ($VAR) und Anführungszeichen-Behandlung. Bestehende Umgebungsvariablen werden nicht überschrieben (außer mit override).

Anwendungsfälle

  • Lokale Konfiguration von Node.js-Projekten
  • Next.js/Vite-Umgebungsvariablen
  • Docker-Compose env_file
  • Isolierung von Testumgebungen

Beispiele

  • Eingabe 
    .env: API_KEY=secret
    Output 
    process.env.API_KEY="secret"

    Loaded into the environment

Häufige Fehler

Loading dotenv in production wastes startup time
Use real environment variables in production and do not load .env

Verwandte Begriffe

ENV
Eine ENV-Datei definiert Umgebungsvariablen im Format KEY=VALUE für die Anwendungskonfiguration; sie ist der empfohlene Ansatz von 12-Factor-Apps.
GLOSSAR
INI
INI ist ein traditionelles Konfigurationsdateiformat, das Einstellungen mit [section]-Headern und key=value-Paaren gruppiert; es ist einfach, aber nicht standardisiert, und Implementierungen weichen leicht ab.
GLOSSAR
Properties
Java-Properties-Dateien nutzen das Format SCHLUESSEL=WERT oder SCHLUESSEL:WERT; sie sind das traditionelle Konfigurationsformat des Java-Ökosystems und unterstützen Unicode-Escapes.
GLOSSAR

Verwandte Tools

ENV-Parser
Parst KEY=VALUE-Zeilen im .env-Stil zu JSON. Leerzeilen und #-Kommentare werden übersprungen. Weitere dotenv-Konventionen sind nicht implementiert: Ein „export “-Präfix bleibt im Schlüssel stehen (export PORT=3000 → „export PORT“), und Anführungszeichen um Werte bleiben unverändert erhalten.
WERKZEUG
ENV-Serialisierung
ENV Stringify — reines Client-seitiges Tool. Datenschutz zuerst, kein Server-Roundtrip.
WERKZEUG
JSON zu ENV
Json To Env — reines Client-seitiges Tool. Datenschutz zuerst, kein Server-Roundtrip.
WERKZEUG
YAML zu ENV
Yaml To Env — reines Client-seitiges Tool. Datenschutz zuerst, kein Server-Roundtrip.
WERKZEUG

References