JSON을 .env로 변환하는 도구

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

주요 기능

예제

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

사용 방법

1. 1

   JSON 객체 붙여넣기

   위의 입력란에 평면 JSON 객체를 입력하거나 붙여넣으세요. '예제 불러오기'를 클릭해 설정 객체, 따옴표가 필요한 값 또는 중첩 객체를 시험해 볼 수도 있습니다.

2. 2

   실시간 .env 출력 확인

   .env 파일이 출력 패널에 즉시 나타납니다. UPPER_SNAKE_CASE 이름을 원하면 '키 정규화'를 켜고, 파일을 셸에서 source할 거라면 'export 접두사 추가'를 켜세요.

3. 3

   복사 또는 다운로드

   복사를 눌러 .env를 클립보드에 가져오거나, 다운로드를 눌러 .env 파일로 저장하세요 — 프로젝트에 바로 넣어 dotenv로 불러올 준비가 되었습니다.

흔한 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"}

일반적인 사용 사례

설정 내보내기에서 .env 생성

API, 설정 대시보드 또는 시크릿 관리자에서 가져온 JSON 설정 내보내기를 로컬 개발이나 컨테이너에 바로 쓸 수 있는 .env 파일로 바꾸세요.

.env 템플릿 스캐폴딩

새 서비스에 필요한 변수를 설명하는 JSON 객체를 만들고, 이를 .env로 변환한 뒤, .env.example을 커밋해 팀원이 어떤 키를 채워야 하는지 정확히 알 수 있게 하세요.

JSON 설정 도구를 dotenv에 연결

일부 도구는 설정을 JSON으로 내보내지만 런타임은 .env를 기대합니다. JSON 출력을 dotenv 형식으로 변환해 파이프라인의 양쪽이 같은 변수에 동의하게 하세요.

source 가능한 셸 env 파일 생성

export 접두사를 켜서 셸이나 CI 단계에서 직접 source할 수 있는 파일을 생성하세요. JSON 설정 덩어리를 한 번의 붙여넣기로 내보내진 환경 변수로 바꿉니다.

설정 왕복

이를 .env을 JSON으로 변환하는 도구와 짝지어 설정을 구조화된 JSON으로 편집하고 다시 .env로 쓰세요 — 왕복 안전한 따옴표 처리가 값이 양방향에서 살아남도록 보장합니다.

혼합된 대소문자 키 정규화

키 정규화 옵션으로 camelCase나 kebab-case 키가 있는 JSON 객체를 일관된 UPPER_SNAKE_CASE 변수 이름의 .env로 변환하여 환경 변수 관례에 맞추세요.

기술 세부 정보

객체 전용 입력과 타입별 직렬화

입력은 브라우저의 네이티브 JSON.parse()로 파싱되며 최상위 객체여야 합니다. 배열과 스칼라는 명확한 오류와 함께 거부됩니다. 각 최상위 속성은 타입별로 직렬화됩니다: 숫자와 불리언은 따옴표 없이 작성되고, null은 빈 값(KEY=)이 되며, 문자열은 공백, 줄바꿈, # 또는 따옴표를 포함하지 않는 한 직접 작성되고, 포함하면 왕복 안전을 위해 큰따옴표로 감싸지고 이스케이프됩니다.

중첩 값과 키 정규화

중첩 객체와 배열은 압축된 JSON.stringify로 직렬화되어 큰따옴표로 감싸지고 이스케이프되며, 평탄화된 키를 지명하는 경고가 함께 표시됩니다. 선택적 키 정규화 단계는 키를 UPPER_SNAKE_CASE로 변환하여 대부분의 유효하지 않은 이름을 해결합니다. 키를 그대로 유지하면 [A-Za-z_][A-Za-z0-9_]*에 맞지 않는 키가 유효하지 않은 이름 경고를 일으킵니다. 선택적 export 접두사를 모든 줄에 추가할 수 있습니다.

브라우저 기반 — 업로드 없음, 서버 없음

모든 처리가 브라우저의 자바스크립트 엔진 안에서만 일어나며, JSON 데이터가 어느 시점에도 네트워크로 전송되지 않습니다. 직렬화기가 외부 의존성 없이 자체 제작되었습니다. Node dotenv 라이브러리는 브라우저에서 안전하지 않기 때문입니다. 200KB를 초과하는 입력은 브라우저 응답성을 유지하기 위해 실시간 모드에서 수동 모드(명시적 변환 클릭)로 전환됩니다.

모범 사례

env 관례가 필요하지 않으면 키를 그대로 유지하세요

소비하는 앱이 이미 JSON의 정확한 키 이름을 기대한다면 키 정규화를 꺼서 아무것도 예기치 않게 이름이 바뀌지 않게 하세요. 환경 변수가 관례적으로 사용하는 UPPER_SNAKE_CASE 관례를 특별히 원할 때만 켜세요.

중첩을 우연이 아니라 의도적으로 평탄화하세요

중첩 값은 .env에서 불투명한 JSON 문자열이 되며, 대부분의 앱은 이를 자동으로 다시 파싱하지 못합니다. 평탄화 경고가 보이면 변환하기 전에 JSON을 평면적인 접두사 키(DB_HOST, DB_PORT)로 재구성하거나 YAML 같은 구조화된 형식을 선택하는 것이 좋습니다.

왕복을 위해 자동 따옴표 처리를 신뢰하세요

언제 따옴표를 칠지 도구에 맡기세요 — 필요한 값만 큰따옴표로 감싸고 이스케이프합니다. 이로써 .env를 읽기 좋게 유지하면서, 공백, 줄바꿈, #이 있는 값이 .env을 JSON으로 변환하는 도구를 거치는 왕복에서 바뀌지 않고 살아남도록 보장합니다.

브라우저 전용 도구에서만 시크릿을 생성하세요

여기서 변환하는 JSON은 사실상 자격 증명 집합입니다. 전적으로 브라우저에서 실행되는 도구에서만 .env를 생성하세요. DevTools에서 네트워크 요청이 0건임을 확인하세요. 이 변환기는 서버 측이나 API 기반 생성기와 달리 그 조건을 충족합니다.

먼저 JSON 입력을 검증하세요

JSON이 손으로 작성되었거나 스크립트로 조립된 것이라면, 먼저 JSON 포맷터로 검증해 끝의 쉼표나 따옴표 없는 키를 잡으세요. 그래야 혼란스러운 파싱 오류 대신 깔끔한 .env를 얻습니다.

자주 묻는 질문