Skip to main content

Environment Variables


환경변수


  • 환경변수는 process.env.<envKey>를 통해 접근할 수 있습니다.
  • 기본적으로 환경변수는 Node.js 환경에서만 사용 가능합니다.

브라우저에 환경변수 노출하기

  • 브라우저에도 노출하려는 환경변수는 NEXT_PUBLIC_ 접두사를 붙여야 합니다

Static

console.log(process.env.NEXT_PUBLIC_ENV_KEY);
  • process.env.NEXT_PUBLIC_와 같이 환경변수에 접근하는 코드는 빌드 시점에 인라인되므로, 빌드 이후에 변경할 수 없습니다
  • 환경변수 값에 따른 분기 코드는 최적화 될 수 있습니다

Dynamic

const envKey = "NEXT_PUBLIC_ENV_KEY";
console.log(process.env[envKey]);

const env = process.env;
console.log(env.NEXT_PUBLIC_ENV_KEY);
  • 변수를 사용하는 환경변수는 실행 시점에 결정됩니다(아직 테스트해보지 못함)

.env

환경변수를 아래와 같은 순서로 조회하며, 찾게되면 더 이상 조회하지 않습니다. NODE_ENVproduction|development|test 중 하나입니다.

  1. process.env
  2. .env.$(NODE_ENV).local
  3. .env.local(NODE_ENV=test 인 경우 확인 안함)
  4. .env.$(NODE_ENV)
  5. .env