도라에몽주머니

[환경구축] 윈도우 환경에서 pyenv와 poetry로 파이썬 환경 구축하기 본문

Study/Python

[환경구축] 윈도우 환경에서 pyenv와 poetry로 파이썬 환경 구축하기

에몽쓰 2025. 1. 5. 21:55

이번에 노트북을 새로 구입해서 파이썬 환경을 새로 구축했다. 회사에서 pyenv + poetry 조합으로 파이썬 환경을 사용하고 있어서 개인 PC에도 동일하게 설정했다.

 

pyenv

pyenv 란?

pyenv는 다양한 버전의 파이썬을 관리하는 도구이다. 회사에서는 안건마다 파이썬 버전을 다르게 사용하기 때문에 pyenv로 파이썬 버전을 관리하고 있다.

https://github.com/pyenv/pyenv

 

pyenv 환경 구축

pyenv 환경을 구축하기 위해서는 우선 로컬에 시스템 파이썬을 설치해야한다. 아래 공식 웹사이트에서 설치하면 된다.

https://www.python.org/downloads/

 

Download Python

The official home of the Python Programming Language

www.python.org

 

아래는 pyenv 도큐먼트인데 공식적으로는 윈도우를 지원하지 않는다.

https://github.com/pyenv/pyenv

 

GitHub - pyenv/pyenv: Simple Python version management

Simple Python version management. Contribute to pyenv/pyenv development by creating an account on GitHub.

github.com

 

그래서 wsl 등을 사용해 리눅스 상에 구축하기도 하는데, 윈도우 환경에서 사용하고 싶다면 아래 링크를 통해 설치하면 된다.

https://github.com/pyenv-win/pyenv-win

 

GitHub - pyenv-win/pyenv-win: pyenv for Windows. pyenv is a simple python version management tool. It lets you easily switch bet

pyenv for Windows. pyenv is a simple python version management tool. It lets you easily switch between multiple versions of Python. It's simple, unobtrusive, and follows the UNIX tradition of s...

github.com

 

윈도우에 pyenv를 설치하기 위해, PowerShell을 열고 아래 명령어를 입력한다.

pip install pyenv-win --target $HOME\.pyenv

 

환경변수 추가를 위해 아래 4개의 명령어를 입력한다.

[System.Environment]::SetEnvironmentVariable('PYENV',$env:USERPROFILE + "\.pyenv\pyenv-win\","User")
[System.Environment]::SetEnvironmentVariable('PYENV_ROOT',$env:USERPROFILE + "\.pyenv\pyenv-win\","User")
[System.Environment]::SetEnvironmentVariable('PYENV_HOME',$env:USERPROFILE + "\.pyenv\pyenv-win\","User")
[System.Environment]::SetEnvironmentVariable('path', $env:USERPROFILE + "\.pyenv\pyenv-win\bin;" + $env:USERPROFILE + "\.pyenv\pyenv-win\shims;" + [System.Environment]::GetEnvironmentVariable('path', "User"),"User")

 

위 명령을 모두 작성한 후, cmd에서 잘 설치되었는지 확인한다.

pyenv --version

 

나는 pyenv 설치 가능한 버전을 확인하고 3.11.0b4 버전으로 설치했다.

pyenv install --list  # 사용 가능한 파이썬 버전 확인
pyenv install 3.11.0b4

 

poetry

poetry는 파이썬 패키지의 의존성을 관리하는 툴이다.

 

poetry 환경 구축

https://python-poetry.org/docs/#installing-with-the-official-installer

 

Introduction | Documentation | Poetry - Python dependency management and packaging made easy

If you installed using the deprecated get-poetry.py script, you should remove the path it uses manually, e.g. rm -rf "${POETRY_HOME:-~/.poetry}" Also remove ~/.poetry/bin from your $PATH in your shell configuration, if it is present.

python-poetry.org

 

우선 poetry 설치 메뉴얼 페이지에서 명령어를 확인 후 PowerShell에 입력한다.

(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -

 

 

설치가 완료되었다면 PC의 환경변수에 들어가서 사용자 환경 변수에 아래 경로를 추가한다. (시스템 속성 > 고급 > 환경 변수)

환경변수의 Path를 더블클릭해서 추가해주면 된다.

%appdata%\Python\Scripts

 

쉘을 재기동하고 아래 명령을 입력했을 때, 이하와 같이 poetry에서 사용할 수 있는 명령어들이 나오면 잘 설치된 것이다.

poetry