✅ 왜 .env와 .env.example을 나누는가?

팀원 모두가 같은 설정 구조를 사용하되, 실제 개인 환경 값이나 비밀번호는 Git에 올리지 않기 위함.

팀 프로젝트에서는 DB 계정, DB 비밀번호, JWT Secret 같은 설정값이 필요합니다. 하지만 이런 값들을 application.yml이나 compose.yaml에 직접 고정해서 커밋하면 다음 문제가 생깁니다.

• 팀원마다 로컬 DB 포트나 계정이 다를 수 있음
• 비밀번호, JWT Secret 같은 민감 정보가 Git에 올라갈 수 있음
• 운영 환경과 로컬 환경의 설정을 분리하기 어려움
• 설정 값이 바뀔 때마다 코드 파일이 변경됨

그래서 설정 값은 코드에 직접 하드 코딩 하지 않고, 환경 변수로 분리합니다.

✅ .env.example이란?

환경변수 템플릿 파일 → 프로젝트를 실행하기 위해 어떤 환경 변수가 필요한지 팀원들에게 알려주는 샘플 파일

이 파일은 Git에 커밋합니다.

예시:

DB_HOST=localhost
DB_PORT=5432
DB_NAME=delivery
DB_USERNAME=delivery_user
DB_PASSWORD=delivery_password

JWT_SECRET=please-change-this-secret-key-for-local-dev-at-least-32bytes
JWT_ACCESS_TOKEN_EXPIRATION=3600000

⚠️.env.example에는 실제 운영 비밀번호나 민감한 Secret을 넣지 않습니다.
		로컬 개발용 기본값이나 예시값만 넣습니다.

✅ .env란?