맥 OS 환경에서 가상환경으로 pyton 버전과 패키지를 관리하기 위해 poetry를 이용한 프로젝트를 생성하고, VSCode IDE를 활용하기 위해 프로젝트를 셋팅하는 방법을 정리했습니다.
poetry가 2.0.1로 업데이트 되면서 poetry shell이 플러그인으로 빠지면서 poetry shell로 해당 프로젝트의 가상환경 경로를 확인하기 위해서는 poetry 플러그인을 별도로 추가해야합니다.
1. pyenv 설치 및 Python 버전 관리
1.1 Homebrew로 pyenv 설치
1) 터미널에서 아래 명령어를 실행하여 pyenv를 설치합니다.
brew install pyenv
2) 설치확인
pyenv --version1.2 pyenv 초기화
1) ~/.zshrc 또는 ~/.bash_profile 파일에 아래 내용을 추가하여 pyenv를 초기화합니다
export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init --path)"
eval "$(pyenv init -)"2) 변경사항을 적용합니다.
source ~/.zshrc1.3 Python 버전 설치
1. 설치 가능한 Python 버전 확인
pyenv install --list
2. 원하는 Python 버전 설치 (예: 3.10.9)
pyenv install 3.10.9
3. 설치된 Python 버전을 확인
pyenv versions
4. 프로젝트 디렉토리에서 해당 Python 버전을 사용하도록 설정
(이 명령은 현재 디렉토리에 .python-version 파일을 생성하여 Python 버전을 고정합니다.)
pyenv local 3.10.9
5. Python 버전 확인
python --version2. Poetry 설치 및 설정
2.1 Poetry 설치
1. Poetry를 설치합니다.
curl -sSL https://install.python-poetry.org | python3 -
2. 설치된 Poetry 확인
poetry --version
3. Poetry PATH에 환경변수에 추가
export PATH="$HOME/.local/bin:$PATH"
source ~/.zshrc
2.2 Poetry 가상환경 설정 변경 (옵션, 필요하면 추가)
가상환경을 프로젝트 폴더 내부에 생성하려면 아래 명령어를 실행.
poetry config virtualenvs.in-project true3. Poetry로 Python 프로젝트 생성
3.1 새 프로젝트 폴더 만들기
1. 터미널에서 새 프로젝트 폴더를 생성
- 프로젝트 생성 이후 poetry init을 통해 가상환경 설치도 가능,
- poetry new를 쓰면 프로젝트 폴더와 global python버전에 맞춰 자동으로 poetry init이 실행됨
poetry new <프로젝트명>
- poery new로 프로젝트를 생성하면 .toml, .md, 프로젝트 폴더, 테스트 폴더가 자동으로 생성됩니다.
my_project
├── pyproject.toml
├── README.md
├── my_project
│ └── __init__.py
└── tests
└── __init__.py
2. 생성한 프로젝트에서 vscode 열기
code .
3.2 Poetry 가상환경 생성 및 활성화
1. 가상환경 생성 및 기본 의존성 설치
- poetry install은 pyproject.toml에 정의된 의존성을 설치하고, 가성환경을 생성한다.
poetry install
2. poetry plugin shell 설치
- poetry 최신버전 (2.0.1)부터는 poetry shell이 플러그인으로 빠짐.
- poetry 가상환경의 python을 활성화 하려면 poetry-plugin-shell을 추가 설치해야함
poetry self add poetry-plugin-shell
3. 가상환경 활성화
- poetry shell로 가상환경을 Activation 하면 가상환경이 설치된 경로를 확인가능하다.
- Activation된 경로를 확인해 Python 인터프리터 경로를 지정
poetry shell
4. Poetry shell 가상환경 종료
exit5. VSCode Python 인터프리터 연결
5.1 Python 확장 설치 (VSCode에 Python 인터프리터가 설치되지 않은 경우만)
- VS Code의 확장 탭(단축키 Cmd+Shift+X)에서 Python을 검색하고 설치합니다.
5.2 Python 인터프리터 선택
1. Ctrl+Shift+P 또는 Cmd+Shift+P를 눌러 **“Python: Select Interpreter”**를 검색합니다.
2. Poetry가 생성한 가상환경을 선택합니다.
- 가상환경은 일반적으로 프로젝트 폴더 내부의 .venv 디렉토리나 ~/.cache/pypoetry/virtualenvs/에 위치합니다.
- 예제 이미지를 참고하면 ~/Library/Caches/pypoetry/virtualenvs/learning-llm-rag-2H8G62gE-py3.11에 가상환경이 있습니다.
- Enter interpreter path... > Find... > 파인더에서 Command + Shift + g > 경로 입력 > bin > python3 선택
6. 코드 작성 및 실행
6.1 프로젝트 폴더에서 Python파일 생성 (예: main.py)
- 간단한 print로 인터프리터가 잘 동작하는지 확인
- VSCode 실행은 F5나 왼쪽 실행버튼으로 코드를 실행.
맺음말
poetry업데이트로 기존에 다른 사람들이 정리해놓은 Poetry 가상환경 설정 방법이 제대로 실행되지 않아 VSCode 프로젝트에서 Python 프로젝트를 생성하는 방법도 정리할겸 작성해봤습니다. poetry shell 이외에는 기존 방식과 동일합니다.