.env 파일은 애플리케이션의 환경 변수를 설정하는 파일이다. 이 파일은 보통 데이터베이스 연결 정보, API 키, 비밀 토큰 등과 같은 중요한 정보를 저장한다. 이를 통해 애플리케이션의 설정 값을 중앙에서 관리할 수 있으며, 민감한 정보를 코드에 직접 노출시키지 않는다.
.env 파일의 개념
.env 파일은 텍스트 파일로 작성되며, 각 줄마다 변수=값 형식으로 설정 값을 지정한다. 예를 들어 아래와 같이 작성한다.
#.env
NAME="comgongstone"
AGE=24
TOKEN='d5f4484dfsaweg5157ds'
위 예제에서 따옴표의 사용 여부에 관계없이 모든 값은 문자열로 인식된다.
.env 파일의 사용 목적
- 설정 값을 중앙에서 관리한다.
- 보안상 민감한 정보를 코드에 직접 포함시키지 않는다.
.env 파일 생성 방법
원하는 폴더에 .env 파일을 생성한 후, 위와 같이 환경 변수 값을 입력하면 된다.

Python에서 .env 파일 불러오기
Python에서 .env 파일을 사용하기 위해 python-dotenv 패키지를 설치한다.
1. python-dotenv 설치
터미널에서 아래 명령어를 실행하여 패키지를 설치한다.
pip install python-dotenv
2. 환경 변수 불러오기
아래 코드를 사용하여 .env 파일에 저장된 환경 변수를 불러온다.
import os
from dotenv import load_dotenv
# 현재 디렉토리의 .env 파일을 불러온다.
load_dotenv()
NAME = os.environ.get("NAME")
AGE = os.environ.get("AGE")
TOKEN = os.environ.get("TOKEN")
print("type:", type(NAME), "|", NAME)
print("type:", type(AGE), "|", AGE)
print("type:", type(TOKEN), "|", TOKEN)
실행 결과는 아래와 같이 출력된다.
type: <class 'str'> | comgongstone
type: <class 'str'> | 24
type: <class 'str'> | d5f4484dfsaweg5157ds
또한, load_dotenv() 함수에 경로를 인자로 전달하면 다른 디렉토리에 있는 .env 파일도 불러올 수 있다.
gitignore에 .env 파일 추가하기
보안상의 이유로 .env 파일은 버전 관리에서 제외한다. 프로젝트 루트 디렉토리에 .gitignore 파일을 생성하거나 수정하여 아래와 같이 추가한다.
#.gitignore
.env
이를 통해 프로젝트에서 안전하게 환경 변수를 관리할 수 있다.