Pyenv와 Virtualenv로 프로젝트별 Python 환경 설정하기

엔케이·2025년 1월 16일
post-thumbnail

Pyenv로 Python 3.10.0 가상환경 설정하기

pyenv를 사용하여 특정 프로젝트에서만 Python 3.10.0 가상환경을 설정하는 방법을 단계별로 알아보겠습니다.


1. Pyenv 설치 확인

pyenv가 설치되어 있는지 확인합니다. 없다면 아래 명령어로 설치합니다.

MacOS/Linux:

brew install pyenv

Windows:

Windows에서는 pyenv-win을 설치합니다.

설치 완료 후, pyenv 명령어가 동작하는지 확인합니다.

pyenv --version

2. Python 3.10.0 설치

pyenv를 통해 Python 3.10.0을 설치합니다.

pyenv install 3.10.0

설치 가능한 Python 버전을 확인하려면 아래 명령어를 실행합니다.

pyenv install --list

3. 프로젝트 디렉토리로 이동

해당 Python 버전을 특정 프로젝트에서만 사용하려면 프로젝트 디렉토리로 이동합니다.

cd /path/to/your/project

4. 로컬 Python 버전 설정

현재 디렉토리에서 Python 3.10.0을 기본으로 사용하도록 설정합니다.

pyenv local 3.10.0

이 명령은 .python-version 파일을 생성하여 해당 디렉토리에서만 설정된 버전을 사용하게 만듭니다.


5. 가상환경 생성

pyenv-virtualenv를 사용하여 가상환경을 설정합니다.

pyenv-virtualenv 설치 확인

pyenv-virtualenv 플러그인이 설치되어 있는지 확인하고, 설치되지 않았다면 설치합니다.

brew install pyenv-virtualenv

.bashrc or .zshrc 에 아래 내용 추가

export PATH="~/.pyenv/bin:$PATH"
eval "$(pyenv init -)"
eval "$(pyenv virtualenv-init -)"

가상환경 생성

pyenv virtualenv 3.10.0 my_project_env

가상환경 활성화

pyenv local my_project_env

6. 설정 확인

설정된 Python 버전과 가상환경을 확인합니다.

python --version
pyenv version

7. 패키지 설치 및 작업

이제 해당 디렉토리에서만 가상환경이 활성화됩니다. 필요한 패키지를 설치하고 프로젝트를 진행합니다.

pip install <package-name>

요약 명령어

pyenv install 3.10.0
cd /path/to/your/project
pyenv virtualenv 3.10.0 my_project_env
pyenv local my_project_env
python --version

위 단계를 따라하면 특정 프로젝트에서만 Python 3.10.0 가상환경을 사용할 수 있습니다!

profile
FE 개발자

0개의 댓글