개발 기본
환경변수(Environment Variable)
환경변수(Environment Variable)은(는) 바이브 코딩 중 자주 마주치는 핵심 개념입니다. 정의만 외우기보다 실제 작업 흐름에서 어떤 역할을 하는지 이해하는 것이 중요합니다.
쉬운 설명
코드 밖에서 설정값과 비밀값을 주입하는 방식.
배경과 쓰임까지 이해하기
조금 더 자세히
환경변수(Environment Variable)는 코드 안에 직접 쓰기 어려운 설정값을 코드 밖에서 주입하는 방식입니다. 보통 API 키(API Key), 데이터베이스 주소, 실행 모드, 배포 환경 이름처럼 환경마다 달라지거나 공개되면 안 되는 값을 담습니다. 예를 들어 로컬에서는 `.env` 파일에 값을 넣고, 버셀(Vercel)이나 서버에서는 대시보드나 서버 설정에 같은 값을 등록합니다.
OpenAI 키, 데이터베이스 URL, OAuth 비밀값, 웹훅 시크릿, 기능 플래그 같은 값이 대표적입니다. 공개되는 프론트엔드 변수와 서버 전용 비밀값을 구분해야 합니다. 한마디로, 환경변수(Environment Variable)는 설정값과 비밀값을 코드 밖에서 안전하게 관리하는 방법입니다.
실제로는 이렇게 만나요
로컬에서는 `.env` 파일에 `OPENAI_API_KEY=...`를 넣고, 버셀(Vercel)에서는 프로젝트 설정의 Environment Variables에 같은 값을 등록합니다.
- 이런 거 할 때 나와요 API 키(API Key), 데이터베이스(Database) 주소, 실행 모드처럼 환경마다 달라지는 값을 안전하게 관리할 수 있습니다.
- 이렇게 생겼어요 `OPENAI_API_KEY=...`처럼 이름과 값을 한 줄로 적는 형태로 자주 보입니다.
- 나오는 화면 예시 .env 파일, Vercel 프로젝트 설정, 배포 로그의 환경변수 누락 오류
헷갈리기 쉬운 점
프론트엔드(Frontend)에 공개되는 환경변수와 서버에서만 쓰는 환경변수를 구분해야 합니다. 공개 prefix가 붙은 값은 사용자가 볼 수 있습니다.
왜 알아두면 좋을까요?
API 키(API Key), 데이터베이스(Database) 주소, 실행 모드처럼 환경마다 달라지는 값을 안전하게 관리할 수 있습니다.
Checklist
실제로 볼 때 확인할 것
- 01
비밀값은 서버 전용으로 둔다
- 02
배포 환경에도 같은 키를 설정한다
- 03
.env 파일은 Git에 올리지 않는다