motdotla/dotenv

어떤 프로젝트인가요?

핵심 기능

• 01한 번의 config() 호출로 .env의 키-값 쌍을 process.env에 불러옵니다.
• 02문자열이나 Buffer를 객체로 변환하는 parse()를 제공합니다.
• 03사용자 지정 대상 객체에 값을 기록하는 populate()를 제공합니다.
• 04명령을 실행하기 전에 환경 변수를 주입하는 dotenv run CLI를 포함합니다.
• 05여러 env 파일을 순서대로 불러오며, 선택적으로 override할 수 있습니다.
• 06의존성이 없으며 dotenv/config를 통한 ESM import를 지원합니다.

활용 사례

• Node.js 서비스의 API 키와 데이터베이스 URL을 소스 코드와 분리해 관리합니다.
• 로컬, 테스트, 프로덕션 환경에서 서로 다른 .env 파일을 사용합니다.
• dotenv run으로 테스트 명령이나 스크립트에 환경 변수를 주입합니다.
• parse() 함수로 사용자 지정 도구에서 env 형식의 텍스트를 파싱합니다.

빠른 시작

1. 1

   npm으로 dotenv를 설치합니다

   npm install dotenv --save
2. 2

   프로젝트 루트에 변수를 입력한 .env 파일을 만듭니다

3. 3

   애플리케이션 시작 시 dotenv를 불러옵니다

4. 4

   node로 앱을 실행합니다

   node index.js

사용 전 알아둘 점

• !변수 확장 및 명령어 치환에는 별도의 dotenvx 도구가 필요합니다.
• !값을 따옴표로 묶지 않으면 #부터 주석으로 처리됩니다. 이는 v15부터 적용된 호환성이 깨지는 변경 사항입니다.

포함된 컬렉션

토픽

자주 묻는 질문

dotenv은(는) 무엇인가요?

의존성 없이 .env 파일의 환경 변수를 Node.js의 process.env에 불러오는 모듈입니다. dotenv는 .env 파일의 키-값 쌍을 Node.js 애플리케이션의 process.env에 불러와, Twelve-Factor App 방식에 따라 설정과 시크릿을 소스 코드 밖에서 관리할 수 있게 합니다. 프로젝트 루트에 .env 파일을 만들고 가능한 한 일찍 config()를 호출한 다음, 평소처럼 process.env를 통해 값을 읽으면 됩니다.

dotenv은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

dotenv은(는) BSD-2-Clause 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

dotenv은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. dotenv의 마지막 커밋은 2026년 10월 29일입니다.

dotenv은(는) 어디에 사용할 수 있나요?

Node.js 서비스의 API 키와 데이터베이스 URL을 소스 코드와 분리해 관리합니다. 로컬, 테스트, 프로덕션 환경에서 서로 다른 .env 파일을 사용합니다. dotenv run으로 테스트 명령이나 스크립트에 환경 변수를 주입합니다. parse() 함수로 사용자 지정 도구에서 env 형식의 텍스트를 파싱합니다.

dotenv는 어떻게 설치하나요?

npm으로 dotenv를 설치합니다: npm install dotenv --save 프로젝트 루트에 변수를 입력한 .env 파일을 만듭니다 애플리케이션 시작 시 dotenv를 불러옵니다 node로 앱을 실행합니다: node index.js

dotenv은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/motdotla/dotenv