Poetry에서 파이썬 버전 변경 방법 정리

안녕하세요.

이번 글에서는 poetry로 파이썬의 환경을 관리할 때,

base가 되는 python 자체의 버전을 변경하는 방법을 정리해보도록 하겠습니다.

 

 

1. pyproject.toml 파일 확인

먼저, 프로젝트 의존성 파일(pyproject.toml)에서 변경하려는 파이썬 버전을

지원하고 있는지 확인해야 합니다.

[tool.poetry.dependencies]
python = ">=3.10,<3.13"

# 또는

python = "^3.10"

 

위와 같은 조건에서 새로운 파이썬 버전을 지원하는지 확인하고, 

지원하지 않는다면 파일을 수정해줍니다.

 

 

2. 파이썬 버전 변경 명령어

만일, 변경하려는 파이썬의 버전이 3.12이고, python 3.12가 이미 설치된 상황이라면

다음과 같은 명령어를 통하여 손쉽게 변경이 완료됩니다.

poetry env use python3.12

 

또는 python이 설치된 경로를 명시적으로 지정하는 것도 가능합니다.

poetry env use /usr/bin/python3.12

 

이후에, poetry install 명령어로 프로젝트의 의존성을 재설치하면 됩니다.

 

그러나, 만일 python 3.12의 설치가 새롭게 필요한 경우에는 다음 단계를 따라야합니다.

 

 

3. 특정 버전의 파이썬 설치 (필요 시)

원하는 버전의 파이썬 설치가 필요한 경우에는 pyenv로 먼저 설치를 진행하고 위의 2번 스텝을

다시 시도해보시면 됩니다.

 

pyenv 패키지의 설치 과정 또한 필요하다면 아래에 첨부한 글을 참고해보세요.

Python pyenv 설치 방법과 사용법 (완벽 가이드)

 

pyenv 패키지 설치가 완료되었다면, 

다음과 같이 원하는 파이썬 버전을 지정하여 설치를 진행해줍니다.

pyenv install 3.12.8

 

이후, 프로젝트 디렉토리에서 사용할 python 버전을 지정해줍니다.

pyenv local 3.12.8

 

여기까지 진행이 완료되었다면 위의 2번 스텝을 재시도 해주시면 세팅이 완료됩니다.

 

이 글이 poetry를 활용한 환경 세팅 과정에 도움이 되셨기를 기원하겠습니다.

잘 봐주셔서 감사합니다.