lamarcK 2025. 4. 11. 03:47

env 파일은 "environment"의 약자로, 환경 변수를 저장하는 파일입니다. 주로 다음과 같은 목적으로 사용됩니다:

  1. 민감한 정보 보호
    • API 키
    • 데이터베이스 비밀번호
    • 비밀 토큰
  2. 환경별 설정 관리
    • 개발 환경
    • 테스트 환경
    • 운영 환경

예시

# .env 파일
API_KEY=your_api_key_here
DATABASE_URL=mongodb://localhost:27017
SECRET_KEY=your_secret_key

 

// Node.js에서 사용할 경우
require('dotenv').config();
const apiKey = process.env.API_KEY;

// React에서 사용할 경우
// .env 파일명은 REACT_APP_으로 시작해야 함
const apiKey = process.env.REACT_APP_API_KEY;

주의사항

  • .env 파일은 보안을 위해 .gitignore에 추가하여 깃허브에 올리지 않음
  • 팀원들과 공유할 때는 .env.example 같은 샘플 파일을 만들어 공유
  1. 파일 위치
    • React 프로젝트의 경우: 프로젝트 루트 디렉토리(package.json과 같은 위치)
    • env 파일은 반드시 프로젝트 최상위 경로에 위치해야 함
  2.  네이밍 규칙
    • React의 경우: REACT_APP_ 접두사 필수
      • 예: REACT_APP_API_KEY=your_key_here
    • Node.js의 경우:
      • 접두사 제한 없음
      • 예: API_KEY=your_key_here
  3. 환경별 파일 구분
    • .env: 기본 환경변수
    • .env.local: 로컬 환경변수
    • .env.development: 개발 환경변수
    • .env.production: 배포 환경변수
  4. .gitignore 설정
    • # .gitignore
      .env
      .env.local
      .env.development.local
      .env.test.local
      .env.production.local