.env 파일 파서｜검증 및 포맷 변환

.env 파일 파서란?

.env File Parser & Formatter는 환경 변수 파일 작업을 위한 브라우저 기반 도구입니다. KEY=VALUE 내용을 파싱하여 구문 오류를 감지하고, 중복 키를 식별하며, 파일 통계를 표시합니다. 클릭 한 번으로 변수를 JSON, YAML, Docker --env-file 또는 docker-compose.yml 형식으로 변환하고, 동일한 키가 두 파일에 서로 다른 값으로 나타날 때 대화형 충돌 해결을 통해 두 .env 파일을 병합합니다.

배포 전에 환경 파일을 감사하거나, 다른 형식으로 팀원과 설정을 공유하거나, 기본 .env와 환경별 오버라이드를 결합하거나, 긴 파일을 알파벳 순으로 정렬하여 스캔하기 쉽게 만들 때 사용하세요. 모든 것이 브라우저에서 실행되므로 비밀 정보가 서버에 닿지 않습니다.

주요 기능

• 따옴표 값과 여러 줄을 지원하는 KEY=VALUE 쌍 파싱 — 홑따옴표와 쌍따옴표로 둘러싸인 값은 자동으로 언쿼트됩니다. 인용되지 않은 값 뒤에 오는 인라인 주석은 제거됩니다.
• 경고 배지로 중복 키 감지 — 두 번 이상 나타나는 모든 키는 노란색 경고 아이콘과 함께 검증 패널에 표시됩니다.
• 구문 검증: = 누락, 빈 키, 잘못된 문자 — 파서는 키가 문자 또는 밑줄로 시작하고 영숫자 문자와 밑줄만 포함해야 함을 강제합니다 (/^[a-zA-Z_][a-zA-Z0-9_]*$/). 각 위반은 특정 줄 번호를 보고합니다.
• 변수를 알파벳 순으로 정렬 — 정렬 버튼은 변수를 오름차순 사전식 순서로 입력 텍스트 영역을 다시 작성하여 원래 내용을 대체합니다.
• JSON 형식으로 변환 — 모든 변수 키와 값이 포함된 보기 좋게 형식화된 JSON 객체를 생성합니다.
• YAML 형식으로 변환 — 값에 YAML 특수 문자 (:, #, {, }, [, ], ,, &, *, !, |, >, ', ", %, @, ` `), 불리언과 유사한 문자열 (true, false, yes, no, null`), 순수 숫자 문자열 또는 빈 값이 포함된 경우 자동으로 쌍따옴표로 감쌉니다.
• Docker --env-file 형식으로 변환 — docker run --env-file에 필요한 따옴표 없는 순수 KEY=VALUE 쌍을 출력합니다.
• docker-compose.yml 환경 블록으로 변환 — 리스트 항목 (- KEY=VALUE)이 있는 environment: YAML 블록으로 출력을 감싸, docker-compose.yml 서비스 정의에 바로 붙여넣을 수 있습니다.
• 충돌 감지 및 해결을 통한 두 .env 파일 병합 — 나란히 있는 텍스트 영역 입력. 충돌은 두 값과 함께 나열되므로 적용하기 전에 어느 것을 선택할지 결정할 수 있습니다.
• 통계 표시: 변수 수, 주석, 빈 줄 — 파싱 후 네 개의 카운터가 표시됩니다: 변수, 주석, 빈 줄, 중복.
• 파일 업로드 지원 — 디스크에서 직접 .env, .env.* 또는 .txt 파일을 업로드합니다.
• 100% 클라이언트 측 처리 — 비밀 정보가 브라우저 밖으로 나가지 않습니다.

.env 파일 파서 사용 방법

1단계: .env 내용 입력 또는 업로드

도구 상단의 Parse & Validate 탭과 Merge 탭을 사용하여 두 모드 사이를 전환합니다.

Parse 모드에서 .env 내용을 왼쪽의 입력 텍스트 영역에 직접 붙여넣거나, Upload를 클릭하여 디스크에서 파일을 로드합니다 (.env, .env.*, .txt 파일을 허용합니다). 자신의 데이터 없이 도구의 동작을 탐색하려면 Load Example을 클릭하면 주석, 따옴표 값, 중복 키, 의도적으로 잘못된 줄이 포함된 데모 파일로 입력이 채워집니다.

입력 예시:

# Application Configuration
APP_NAME=my-awesome-app
APP_ENV=production
APP_PORT=3000

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

# Duplicate key (triggers warning)
APP_PORT=8080

# Invalid line (triggers error)
MISSING_EQUALS

2단계: 통계 및 검증 패널 검토

내용을 입력하거나 붙여넣은 후 편집기 아래에 두 패널이 나타납니다:

Statistics는 그리드에 네 개의 카운터를 표시합니다:

• Variables — 유효한 KEY=VALUE 항목 수
• Comments — #으로 시작하는 줄
• Empty Lines — 빈 줄
• Duplicates — 두 번 이상 나타나는 키 (카운터가 0이 아닐 때 노란색으로 변함)

Validation은 발견된 모든 문제를 나열합니다:

• 중복 키는 노란색 삼각형 아이콘과 함께 나타납니다: "Duplicate key: APP_PORT"
• 구문 오류는 빨간색 X 아이콘과 함께 정확한 줄을 인용하며 나타납니다: "Line 14: Missing '=' sign"
• 문제가 없으면 녹색 체크로 확인됩니다: "No issues found"

3단계: 출력 형식 선택

오른쪽 패널의 형식 선택기는 다섯 가지 옵션을 제공합니다:

아무 버튼이나 클릭하면 즉시 출력이 전환됩니다. 모든 형식은 주석 줄과 빈 줄을 제외합니다 — 유효한 변수 항목만 포함됩니다.

.env 출력 형식은 따옴표도 정규화합니다: 공백, # 또는 "을 포함하는 값은 내부 쌍따옴표가 이스케이프된 상태로 자동으로 쌍따옴표로 감싸집니다.

4단계: 정렬 및 복사

Sort를 클릭하면 알파벳 순서로 변수가 있는 입력 텍스트 영역을 다시 작성합니다. 이것은 입력을 제자리에서 수정하므로 정렬된 내용이 파싱 및 출력을 위한 새 소스가 됩니다.

출력 패널 헤더의 Copy를 클릭하여 형식화된 결과를 클립보드에 복사합니다.

5단계: 두 .env 파일 병합 (선택 사항)

Merge 탭으로 전환합니다. File A 텍스트 영역에 .env 파일 하나를 붙여넣거나 업로드하고, File B에 다른 파일을 붙여넣은 다음 Merge Files를 클릭합니다.

• 두 파일에 충돌하는 키(서로 다른 값을 가진 동일한 키)가 없으면 병합이 즉시 완료되고 결과가 추가 편집을 위해 Parse 탭의 입력에 나타납니다.
• 충돌이 있으면 Conflict Resolution 패널이 각 충돌 키를 버튼으로 표시되는 두 값과 함께 나열합니다. 유지하려는 값(A 또는 B)의 버튼을 클릭한 다음 Apply Merge를 클릭하여 선택 사항으로 파일을 결합합니다.

실용적인 예시

배포 전 프로덕션 .env 감사

프로덕션 환경 파일을 붙여넣고 검증 패널을 확인합니다. 단 하나의 "Missing '=' sign" 오류나 중복 키 경고라도 런타임 설정 실패를 일으킬 수 있는 복사-붙여넣기 오류를 나타낼 수 있습니다. Statistics 카운터는 예상 변수 목록과 상호 참조할 빠른 카운트를 제공합니다.

Docker를 위한 변환

Node.js에서 dotenv로 작동하는 .env 파일이 있지만 Docker 컨테이너에 전달해야 합니다. docker run --env-file .env에서 사용하려면 Docker --env-file을 선택하거나, 준비된 environment: 블록을 얻으려면 docker-compose.yml을 선택합니다:

environment:
  - APP_NAME=my-awesome-app
  - APP_ENV=production
  - DATABASE_POOL_SIZE=10

블록을 서비스 정의에 직접 붙여넣습니다.

기본 파일과 오버라이드 파일 병합

프로젝트에 공유 기본값이 있는 .env.base와 개발자별 오버라이드가 있는 .env.local이 있습니다. .env.base를 File A에, .env.local을 File B에 로드하고, Merge Files를 클릭하고, 로컬 오버라이드 값을 선택하여 충돌을 해결한 다음 병합된 출력을 작업용 .env로 복사합니다.

팁과 모범 사례

긴 설정을 붙여넣는 대신 파일을 업로드하세요. 파일 업로드 버튼은 .env, .env.*, .txt 형식을 허용합니다. 이를 통해 클립보드 크기 제한과 터미널에서 복사할 때 발생할 수 있는 우발적인 후행 공백 손상을 방지할 수 있습니다.

diff하기 전에 정렬하세요. 두 환경 파일을 수동으로 비교하는 경우 먼저 둘 다 정렬하세요. 정렬 버튼은 순서를 정규화하여 diff 도구가 다른 변수 순서로 인한 노이즈 대신 의미 있는 변경사항을 찾을 수 있게 합니다.

YAML 출력은 불리언과 유사한 값을 자동으로 따옴표로 감쌉니다. 포맷터는 true, false, yes, no, null과 같은 문자열을 감지하고 쌍따옴표로 감쌉니다. 이를 통해 YAML 파서가 FEATURE_FLAG=true를 문자열 "true"가 아닌 불리언 true로 해석하는 것을 방지합니다.

.env 출력 형식은 공백이 있는 값을 다시 따옴표로 감쌉니다. 입력에 SECRET_KEY=my secret with spaces가 있으면 .env 출력은 SECRET_KEY="my secret with spaces"로 렌더링합니다. 이는 모든 dotenv 호환 로더에 안전하게 복사할 수 있습니다.

인용되지 않은 값의 인라인 주석은 제거됩니다. APP_PORT=3000 # HTTP port와 같은 줄은 값을 3000으로 파싱하여 인라인 주석을 버립니다. DESCRIPTION="hello # world"와 같은 따옴표 값은 #을 값의 일부로 보존합니다.

일반적인 문제 및 문제 해결

"Line N: Missing '=' sign" — 줄에 내용이 있지만 등호가 없습니다. 이것은 export APP_NAME=foo와 같은 셸 내보내기 문을 붙여넣을 때 가장 일반적인 오류입니다. 붙여넣기 전에 export 키워드를 제거하세요.

"Line N: Empty key" — 줄이 =로 시작합니다 (예: =value). 파서는 등호 앞에 비어있지 않은 키를 요구합니다.

"Line N: Invalid key 'MY-KEY'" — POSIX 표준에 따라 환경 변수 키에는 하이픈이 허용되지 않으며, 이 파서는 ^[a-zA-Z_][a-zA-Z0-9_]*$를 강제합니다. 하이픈을 밑줄로 대체하세요: MY_KEY.

중복 키 경고가 있지만 값이 동일함 — 파서는 값이 다른지 여부에 관계없이 두 번 이상 나타나는 모든 키에 플래그를 표시합니다. 입력에서 중복 줄을 제거하세요.

Merge 버튼이 회색으로 표시됨 — File A와 File B 모두 내용이 있어야 합니다. 텍스트 영역 중 하나라도 비어 있으면 버튼이 비활성화됩니다.

YAML 출력에 예상치 못한 따옴표가 있음 — 순수하게 숫자이거나 불리언 리터럴 (true, false, yes, no, null)과 일치하는 값은 문자열 유형을 보존하기 위해 따옴표로 감싸집니다. 이것은 의도적이고 올바른 YAML 동작입니다.

개인 정보 보호 및 보안

.env File Parser는 서버 측 처리 없이 완전히 브라우저에서 실행됩니다. API 키, 데이터베이스 자격 증명, 비밀 토큰을 포함한 환경 변수는 네트워크를 통해 전송되지 않습니다. 파싱, 검증, 형식 변환 및 병합 로직은 모두 로컬에서 실행되는 JavaScript 함수입니다. 도구는 초기 페이지 로드 후 오프라인에서 작동합니다. 서드파티 분석 스크립트는 텍스트 영역 내용에 액세스할 수 없습니다.

자주 묻는 질문

.env File Parser는 무료인가요? 예, 계정 없이 완전히 무료입니다.

실제 API 키와 비밀 정보를 붙여넣어도 안전한가요? 예. 모든 처리는 로컬 JavaScript를 사용하여 브라우저에서 이루어집니다. 아무것도 서버로 전송되지 않습니다. 비밀 정보는 당신의 컴퓨터에 남아 있습니다.

오프라인으로 사용할 수 있나요? 예. 페이지 로드 후 파싱과 변환은 인터넷 연결 없이 작동합니다.

여러 줄 값을 지원하나요? 파서는 한 줄짜리 따옴표 값을 처리합니다. 여러 줄에 걸쳐 있는 진정한 여러 줄 값(백슬래시 연속 또는 heredoc 스타일 구문 사용)은 현재 지원되지 않습니다. 파싱하기 전에 여러 줄 내용을 하나의 따옴표 줄로 분할하세요.

따옴표 값이 출력에서 왜 따옴표가 제거된 상태로 나타나나요? unquoteValue 함수는 전체 값을 감싸는 일치하는 홑따옴표 또는 쌍따옴표를 제거합니다. DATABASE_URL="postgres://..."는 내부적으로 postgres://...가 되고 출력 형식에서 필요에 따라 다시 따옴표로 감싸집니다. 이것은 형식 변환의 올바른 동작입니다.

출력에서 주석 줄은 어떻게 되나요? 주석 (#으로 시작하는 줄)은 모든 출력 형식에서 제외됩니다. 유효한 변수 항목만 포함됩니다. 주석은 Statistics 패널에서 카운트되지만 출력에는 작성되지 않습니다.

두 개 이상의 파일을 병합할 수 있나요? 도구는 한 번에 정확히 두 파일의 병합을 지원합니다. 세 개 이상의 파일을 병합하려면 먼저 A+B를 병합하고, 결과를 Parse 모드에 복사한 다음 File C와의 두 번째 병합을 위해 File A로 사용하세요.

정렬 작업이 주석 줄을 보존하나요? 아니요. 정렬 버튼은 파싱된 유효한 변수만 사용하여 정렬된 입력을 재구성하고 주석 줄과 빈 줄을 버립니다. 깨끗하고 정규화된 파일을 원할 때 정렬을 사용하세요.

Docker --env-file 형식이란 무엇인가요? docker run --env-file은 셸 따옴표 없는 순수 KEY=VALUE 줄을 기대합니다. Docker 출력 형식은 공백이 있는 값에도 따옴표를 생략하는데, 이것은 Docker 형식에는 올바르지만 셸 스크립트에서는 실패합니다. 셸 안전 따옴표가 필요하면 .env 형식을 사용하세요.

병합하지 않고 두 파일 간에 어떤 변수가 다른지 감지할 수 있나요? Merge 모드로 전환하고 Merge Files를 클릭하세요. 충돌 목록은 File A와 File B가 서로 다른 값을 가진 모든 키를 표시하여 다른 변수의 실용적인 diff 역할을 합니다.

관련 도구

• Config Generator — 다양한 프레임워크와 환경을 위한 구조화된 설정 파일을 생성합니다.
• Docker Converter — Docker 관련 설정 형식 간에 변환합니다.
• YAML to TOML — YAML과 TOML 설정 파일 형식 간에 변환합니다.

.env File Parser 지금 사용해보기: .env File Parser & Formatter