윈도우에서 pyenv로 파이썬 버전 쉽게 관리하기: 설치 및 사용법

파이썬을 쓰다 보면, 다양한 프로젝트에서 여러가지 버전을 사용해야 하는 일이 종종 발생합니다. 그렇다고 매번 수동으로 버전을 지정해서 사용하기도 어렵습니다. 그래서 오늘은 pyenv를 이용해서 여러 파이썬 버전을 손쉽게 관리하는 방법을 알아보고자 합니다.

pyenv는 윈도우에서도 쉽고 설치하고, 쉽고 편하게 여러가지 파이썬 버전을 설치하고 관리할 수 있습니다. 이 방법으로 파이썬 버전을 바꾸는 일은 쉽게 해결됩니다.

pyenv란 무엇인가?

하나의 컴퓨터에서 여러 프로젝트를 하다 보면 각 프로젝트마다 요구하는 파이썬 버전이 제각각인 경우가 있습니다. 이럴 때 고민 안 하고 각기 다른 버전의 파이썬을 쓸 수 있게 해주는 멋진 도구가 있습니다. 바로 pyenv인데요.

간단하게 말하면, pyenv는 다양한 버전의 파이썬을 쉽게 설치하고 사용할 수 있게 해주는 관리 도구입니다. 여러 프로젝트에서 서로 다른 파이썬 버전이 필요할 때 pyenv를 사용하면, 다른 버전을 설치하고 전환하는 일이 훨씬 더 수월해지죠.

또한, OS 설정을 직접 건드릴 필요 없이 로컬 프로젝트 수준에서 파이썬 환경을 관리할 수 있습니다. 덕분에 예기치 않은 충돌이나 오류를 예방할 수 있죠.

정리하면 pyenv가 있으면, 내가 원하는 대로 여러 버전의 파이썬을 설치하고 바꿀 수 있습니다.

윈도우에 pyenv 설치하기

이제 pyenv 설치 과정을 알아보겠습니다. 윈도우에서는 pyenv-win을 이용해서 pyenv를 설치할 수 있습니다. pyenv-win 깃허브 공식 페이지로 이동합니다.

스크롤을 내리다보면 Installation 부분에 Powershell을 이용하면, 쉽게 설치할 수 있다는 안내가 있습니다. Quick start 부분에 설치 명령어가 있는데요. 이를 복사하고, 윈도우에서 Powershell을 실행합니다.

Powershell에서 복사한 명령어를 실행합니다. 설치가 완료되면, ‘pyenv-win is successfully installed. You may need to close and reopen your terminal before using it.’ 이라는 메시지가 나옵니다. 혹시 설치가 되지 않으면, Powershell을 관리자 모드로 실행해보세요. 시작 메뉴에서 실행 전에 마우스 우클릭을 하면, ‘관리자 권한으로 실행’ 메뉴가 있습니다.

설치가 종료되면 파워셸을 종료하고, 다시 실행합니다.

파이썬 버전 설치 및 설정 방법

이제 pyenv를 설치했으니, 다양한 파이썬 버전을 설치하는 법을 알아볼까요? pyenv를 이용하면 원하는 파이썬 버전을 목록에서 확인하고 설치할 수 있습니다.

설치 가능한 파이썬 버전 목록을 보려면, 파워셸에서 아래와 같이 입력합니다.

pyenv install --list

리스트가 무척 길지만 걱정 마세요. 필요한 버전만 고르면 됩니다. 설치를 원하는 버전이 눈에 띄면, 아래와 같이 입력합니다. 예를 들어 파이썬 3.12.9를 설치하고 싶다면, 아래 명령어를 파워셸에서 입력하세요. 명령어 프롬프트를 이용해도 됩니다.

또는 3.12까지만 입력해도, 알아서 해당 버전의 가장 최신 버전을 설치합니다.

pyenv install 3.12.9

잠시 기다리면 설치가 완료됩니다. 이제 이 버전을 사용하겠다고, 설정해야 합니다. 기본으로 사용하고 싶은 버전은 아래와 같이 global로 설정하면 됩니다.

pyenv global 3.12.9

이렇게 하면 모든 프로젝트에서 파이썬 3.12.9을 사용할 수 있습니다.

프로젝트별로 다른 버전을 쓰고 싶다면, 그 프로젝트 디렉토리로 이동해서, 아래와 같이 실행합니다.

pyenv local 3.9.1

이 방법을 통해 특정 프로젝트에서는 지정한 버전을 사용할 수 있습니다. 마지막으로, 현재 어떤 버전이 선택돼 있는지 궁금하다면, 아래 명령어로 확인하세요.

pyenv versions

지금까지 기본 버전 설치와 설정 방법에 대해서 알아봤습니다.

사용 시 주의사항 및 팁

버전 변경 후에 가끔 제대로 적용되지 않는 상황이 발생할 수 있습니다. 그럴 때는 파워셸을 닫고 다시 열거나, pyenv rehash 명령어를 실행해보세요.

오늘 소개한 pyenv를 활용하면 파이썬 버전을 쉽게 전환할 수 있습니다. 특히 여러 프로젝트를 동시에 진행하는 개발자에게 매우 유용한 도구입니다. 설치와 사용 방법을 차근차근 따라하고, 익히면 더 이상 프로젝트의 파이썬 버전 관리가 어렵지 않을 거에요. 더 이상 파이썬 버전 문제로 스트레스 받지 마세요. pyenv를 활용해 편리한 개발 환경을 구축해보세요!