환경 변수 관리자

.env 파일을 시각적으로 보기, 편집, 관리 — 텍스트 에디터가 필요 없습니다.

무엇인가요?

환경 변수 관리자는 .env 파일용 시각적 에디터입니다. 이러한 파일은 앱이 런타임에 필요로 하는 구성 값을 저장합니다 — API 키, 데이터베이스 연결 문자열, 기능 플래그 같은 것들입니다. 종종 비밀을 포함하므로 .env 파일은 Git과 소스 코드에서 제외됩니다.

일반 텍스트 에디터에서 .env 파일을 편집하는 것은 작동하지만 실수하기 쉽습니다: 누락된 따옴표, stray 공백 또는 실수로 파일을 Git에 커밋. Env Manager는 변수를 안전하게 편집, 추가, 공개할 수 있는 깔끔한 테이블 인터페이스를 제공합니다.

Env Manager 열기

두 가지 방법이 있습니다:

  • Settings → Environment Variables로 이동
  • 또는 프로젝트 툴바에서 env 아이콘 (프로젝트 패널 상단 근처의 작은 키 아이콘)을 클릭

관리자가 현재 활성 프로젝트에 대해 자동으로 열립니다.

변수 보기 및 편집

관리자는 .env 파일의 모든 키-값 쌍을 테이블에 표시합니다. 각 행은 왼쪽에 변수 이름, 오른쪽에 값을 표시합니다.

기본적으로 값은 숨겨져 있습니다(비밀번호 필드처럼 점으로 표시)하여 화면에서 비밀을 보호합니다. 행의 eye icon을 클릭하여 해당 값을 공개하거나 열 헤더의 eye icon을 클릭하여 모든 값을 한 번에 공개합니다.

값을 편집하려면 테이블에서 직접 클릭합니다. 셀이 편집 가능해집니다 — 새 값을 입력하고 Enter를 눌러 저장합니다. .env 파일이 즉시 업데이트됩니다.

새 변수를 추가하려면 테이블 하단의 + button을 클릭하고 키 이름을 입력하고 Tab을 누르고 값을 입력한 후 Enter를 누릅니다.

프로젝트별 파일

대부분의 프로젝트에는 둘 이상의 .env 파일이 있습니다. 일반적인 설정:

  • .env — 공유 기본값
  • .env.local — 로컬 재정의 (커밋되지 않음)
  • .env.production — 프로덕션 값

Env Manager 상단의 파일 선택 드롭다운을 사용하여 이러한 파일 간에 전환합니다. 각 파일이 별도로 표시되고 편집됩니다.

자동 재로드

Env Manager에서 변경 사항을 저장하면 업데이트된 값이 즉시 파일에 기록됩니다. 개발 서버가 핫 리로드를 지원한다면(예: Next.js 및 Vite 모두 지원) 서버를 재시작하지 않고 새 값이 적용됩니다. 환경 변수를 핫 리로드하지 않는 서버의 경우 터미널에서 재시작 버튼을 사용하세요.

보안

.env 파일은 로컬 머신에 유지됩니다. 1DevTool은 환경 변수 값을 어떤 서버에도 업로드하지 않습니다.

프로젝트를 추가할 때 1DevTool은 .env가 .gitignore에 나열되어 있는지 확인합니다. 그렇지 않다면 실수로 비밀을 커밋하는 것을 방지하기 위해 자동으로 추가합니다.

팁: AI Agent는 환경 변수 이름(값은 아님)을 읽어서 프로젝트 구성을 이해할 수 있으므로 — 설명 없이 DATABASE_URL을 사용해야 함을 압니다.

환경 변수 관리자