pyenv란?
여러 버전의 Python을 쉽게 관리할 수 있도록 도와주는 도구
pyenv가 필요한 이유
- 여러 버전의 Python을 설치 & 전환 기능
ex) 프로젝트마다 Python 3.8, 3.9, 3.11 등 같이 버전이 다를 수 있는데, 이를 쉽게 변경할 수 있다.
- 운영체제에 기본 설치된 Python과 별도로 관리가 가능하다.
- 시스템 Python을 건드리지 않고 독립적인 환경을 만들 수 있다.
- 가상 환경과 함께 사용이 가능하다.(pyenv-virtualenv)
- virtualenv나 venv와 조합해서 프로젝트별로 격리된 환경을 만들 수 있다.
=> pyenv를 이용하면 각 버전의 Python을 동적으로 가져와서 프로젝트별로 다르게 적용할 수 있다.
따라서, 사용자가 일일이 각각의 Python 버전을 PC에 수동으로 설치해야하는 번거로움을 덜 수 있다.
동적으로 환경변수를 바꾸도록 해준다.
pyenv 설치 (Window)
1. 깃허브 공식 홈페이지 접속 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
2. ReadMe 파일 Installation에서 PowerShell 접속
3. 아래 설명 순서대로 진행
3-1. PowerShell 창에서 pyenv 설치 명령어 실행
Invoke-WebRequest -UseBasicParsing -Uri "https://raw.githubusercontent.com/pyenv-win/pyenv-win/master/pyenv-win/install-pyenv-win.ps1" -OutFile "./install-pyenv-win.ps1"; &"./install-pyenv-win.ps1"
=> 성공적으로 설치된 경우
* UnauthorizedAccess 오류가 발생한 경우 *
- 에러 메세지
& : File C:\Users\kirankotari\install-pyenv-win.ps1 cannot be loaded because running scripts is disabled on this system. For more information, see about_Execution_Policies at https:/go.microsoft.com/fwlink/?LinkID=135170. At line:1 char:173 + ... n.ps1" -OutFile "./install-pyenv-win.ps1"; &"./install-pyenv-win.ps1" + ~~~~~~~~~~~~~~~~~~~~~~~~~ + CategoryInfo : SecurityError: (:) [], PSSecurityException + FullyQualifiedErrorId : UnauthorizedAccess
=> PowerShell을 "관리자 권한으로 실행" 후
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine 명령어 실행
여기까지 정상적으로 설치가 되었다면 터미널을 새로 열어준다.
pyenv 설치 경로 확인
$env:PYENV:ROOT
$env:Path -split ";"
pyenv설치 가능한 파이썬 버전 list 확인
$ pyenv install --list특정 Python 버전 설치
pyenv install 3.11.0특정 버전의 Python을 사용하도록 설정
pyenv global 3.9.7 # 시스템 전체에서 사용
pyenv local 3.9.7 # 현재 디렉토리에서만 사용
pyenv shell 3.9.7 # 현재 터미널 세션에서만 사용현재 사용중인 Python 버전 확인
pyenv versions
=> 즉, pyenv를 사용하면 여러 Python 버전을 손쉽게 관리하고, 프로젝트별로 적잘한 버전을 설정할 수 있다.
특히 Python을 자주 업데이트하거나, 여러 프로젝트를 동시에 관리할 때 유용하다.
pyenv 가상환경 생성 및 활성화 (Window)
✅ Windows에서 `virtualenv` 사용 가능 여부
Windows에서도 virtualenv를 설치해서 사용할 수 있지만 pyenv-win은 pyenv-virtualenv를 지원하지 않는다.
(MacOS/Linux에서만 지원)
나는 pyenv-win을 사용해서 파이썬 환경을 설정했기 때문에,
Python 내장 가상환경 venv를 사용하여 가상환경을 설정하도록 하겠다.
venv를 이용한 가상환경 생성
1. 가상환경 생성
가상환경 설정을 하기 위한 프로젝트로 이동하여 아래 명령어를 실행한다.
python -m venv [가상환경 이름]=> 명령으로 가상 환경을 만들면, 명령을 실행하는 폴더 아래에 [가상환경 이름]으로 폴더가 만들어진다.
2. 가상환경 활성화(active)
- Window
[가상환경 이름]/Scripts 폴더에 있는 activate 파일을 실행해서 가상환경을 활성화(activate)한다.
(윈도우 외 운영체제에서는 [가상환경 이름]/bin/activate를 사용한다.
=> 윈도우에서 activate.bat을 실행해봤지만 실행되지 않아서 activate를 실행했더니 작동되었다.
3. 가상환경 활성화 확인
activate 실행 후 프롬프트가 정상적으로 활성화 되면 (가상환경 이름) 같은 표시가 나타난다.
ex) (venv) PS D:\ pythohBackend\ venv \Scripts>
4. 가상환경 비활성화(deactive)
activate와 동일하게 윈도우는 [가상환경 이름]/Scripts 폴더에서, 윈도우 외 운영체제는 [가상환경 이름]/bin 폴더에서
deactivate를 실행하면 가상환경에서 벗어나게 된다.
VSCode에서 가상환경 사용
1. Python Environment Manager 설치
2. VSCode에서 가상환경 목록 확인
=> 1번 아이콘을 눌러 터미널을 열고 실행하고, Workspace를 해당 가상 환경으로 바꾸려면 2번 아이콘을 누르면 상단의 Workspace Environment가 선택한 가상환경으로 바뀐다.
'Python > 기타' 카테고리의 다른 글
| 파이썬 프로그래밍 기초 - 딕셔너리 자료형 (2) | 2025.03.20 |
|---|---|
| (Window) 아나콘다로 파이썬 가상 환경 설치 오류 해결하기 + 아나콘다 가상환경에 대해 (0) | 2025.03.17 |