Konverter JSON ke .env

Apa itu 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"

Fitur Utama

Contoh

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

Cara Menggunakan

1. 1

   Tempel Objek JSON Anda

   Masukkan atau tempel objek JSON datar ke bidang input di atas. Anda juga dapat mengklik 'Muat contoh' untuk mencoba objek config, nilai yang perlu dikutip, atau objek bersarang.

2. 2

   Lihat Output .env Langsung

   File .env muncul seketika di panel output. Aktifkan 'Normalkan kunci' untuk nama UPPER_SNAKE_CASE, atau 'Tambah awalan export' jika file akan di-source di shell.

3. 3

   Salin atau Unduh

   Klik Salin untuk mengambil .env ke clipboard, atau Unduh untuk menyimpannya sebagai file .env — siap dijatuhkan ke proyek Anda dan dimuat dengan dotenv.

Jebakan JSON Umum

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

Kasus Penggunaan Umum

Hasilkan .env dari Ekspor Config

Ambil ekspor konfigurasi JSON dari API, dasbor pengaturan, atau secrets manager dan ubah menjadi file .env siap pakai untuk pengembangan lokal atau kontainer.

Susun Templat .env

Bangun objek JSON yang mendeskripsikan variabel yang dibutuhkan layanan baru, konversi ke .env, dan commit .env.example agar rekan tim tahu persis kunci mana yang harus diisi.

Jembatani Alat Berbasis JSON ke dotenv

Beberapa alat mengeluarkan konfigurasi sebagai JSON sementara runtime Anda mengharapkan .env. Konversi output JSON ke format dotenv agar kedua sisi pipeline sepakat pada variabel yang sama.

Hasilkan File env Shell yang Dapat Di-source

Aktifkan awalan export untuk menghasilkan file yang dapat Anda source langsung di shell atau langkah CI, mengubah blob config JSON menjadi variabel lingkungan terekspor dalam sekali tempel.

Konfigurasi Bolak-Balik

Pasangkan ini dengan Konverter .env ke JSON untuk menyunting konfigurasi sebagai JSON terstruktur dan menulisnya kembali ke .env — pengutipan aman-bolak-balik menjamin nilai bertahan di kedua arah.

Normalkan Kunci Campuran-Kapital

Konversi objek JSON dengan kunci camelCase atau kebab-case menjadi .env dengan nama variabel UPPER_SNAKE_CASE yang konsisten menggunakan opsi Normalkan kunci, sesuai konvensi variabel lingkungan.

Detail Teknis

Input Khusus Objek dengan Serialisasi Bertipe

Input diurai dengan JSON.parse() native browser dan harus berupa objek tingkat atas; array dan skalar ditolak dengan kesalahan yang jelas. Setiap properti tingkat atas diserialkan menurut tipe: angka dan boolean ditulis telanjang, null menjadi nilai kosong (KEY=), dan string ditulis langsung kecuali jika mengandung spasi, baris baru, # atau tanda kutip, yang dalam hal itu dikutip ganda dan di-escape untuk keamanan bolak-balik.

Nilai Bersarang dan Normalisasi Kunci

Objek dan array bersarang diserialkan dengan JSON.stringify ringkas, dikutip ganda dan di-escape, dengan peringatan yang menyebut kunci yang diratakan. Langkah Normalkan kunci opsional mengonversi kunci ke UPPER_SNAKE_CASE, menyelesaikan sebagian besar nama tidak valid; ketika kunci dijaga apa adanya, kunci apa pun yang tidak cocok dengan [A-Za-z_][A-Za-z0-9_]* memicu peringatan nama tidak valid. Awalan export opsional dapat ditambahkan ke setiap baris.

Berbasis Browser — Tanpa Unggah, Tanpa Server

Semua pemrosesan terjadi sepenuhnya di mesin JavaScript browser Anda; tidak ada data JSON yang ditransmisikan melalui jaringan kapan pun. Serializer ditulis sendiri tanpa dependensi eksternal, karena pustaka dotenv Node tidak aman untuk browser. Input lebih besar dari 200KB beralih dari mode langsung ke mode manual (klik Konversi eksplisit) untuk menjaga browser tetap responsif.

Praktik Terbaik

Jaga Kunci Apa Adanya Kecuali Anda Butuh Konvensi env

Biarkan Normalkan kunci nonaktif ketika aplikasi pengonsumsi sudah mengharapkan nama kunci persis di JSON Anda, agar tidak ada yang diganti namanya secara tak terduga. Aktifkan hanya saat Anda secara khusus menginginkan konvensi UPPER_SNAKE_CASE yang lazim dipakai variabel lingkungan.

Ratakan Penyarangan dengan Sengaja, Bukan Tak Sengaja

Nilai bersarang menjadi string JSON buram di .env, yang tidak bisa diurai kembali secara otomatis oleh sebagian besar aplikasi. Ketika Anda melihat peringatan perataan, lebih baik membentuk ulang JSON menjadi kunci datar berawalan (DB_HOST, DB_PORT) sebelum mengonversi, atau pilih format terstruktur seperti YAML.

Percayakan Pengutipan Otomatis untuk Bolak-Balik

Biarkan alat yang memutuskan kapan mengutip — ia hanya mengutip ganda dan meng-escape nilai yang membutuhkannya. Ini menjaga .env tetap mudah dibaca sambil menjamin nilai dengan spasi, baris baru, atau # bertahan dalam perjalanan bolak-balik kembali melalui Konverter .env ke JSON tanpa berubah.

Hasilkan Secret Hanya di Alat Khusus Browser

JSON yang Anda konversi di sini pada dasarnya adalah sekumpulan kredensial. Hanya hasilkan .env di alat yang berjalan sepenuhnya di browser; verifikasi nol permintaan jaringan di DevTools. Konverter ini memenuhi syarat, tidak seperti generator sisi server atau berbasis API.

Validasi Input JSON Terlebih Dahulu

Jika JSON ditulis tangan atau dirakit oleh skrip, validasi dengan JSON Formatter terlebih dahulu untuk menangkap koma di akhir atau kunci tak berkutip, agar Anda mendapatkan .env yang bersih alih-alih kesalahan parse yang membingungkan.

Pertanyaan yang Sering Diajukan