개발이야기

Python 파이썬에서 가상환경 venv 만들고 실행하기 (feat. 파이썬 버전에 따른 venv 생성오류)

hndev 2024. 10. 14. 14:06

 

 

파이썬을 활용해서 새로운 프로젝트를 만드려고 하는데 가상환경 만드는 과정에서 오류가 났네요..? 그래서 오늘은 이 오류를 알아보고 파이썬에서 가상환경 venv를 만들고 폴더명도 변경해본 후 가상환경 실행까지 해보도록 하겠습니다.

 

vscode에 파이썬이 설치되었는지 확인하는 방법

python --version

 

파이썬이 정상적으로 설치되었다면 설치된 파이썬 버전이 나타납니다.

이어서 파이썬에서 사용할 가상환경 venv(virtual environment) 모듈을 만들어봅니다.

 

파이썬에서 가상환경 venv 만들기

python -m venv venv

 

위의 명령어는 "파이썬에서 venv를 만드는데 venv라는 이름으로 만들어줘" 라는 뜻입니다. 

 

근데..! 다음과 같이 오류가 났습니다.

/System/Library/Frameworks/Python.framework/Versions/2.7/Resources/Python.app/Contents/MacOS/Python: No module named venv

 

이유를 알아보니 venv 가상환경 모듈은 파이썬3 버전에서 지원하는데 현재 적용된 파이썬은 2.7 버전이었던 것..!

그래서 모듈을 만들지 못 하고 오류가 난 것이죠.

 

그래서 일단, 파이썬3 버전이 설치되어있는지부터 확인했습니다.

 


 

vscode에 파이썬3 버전이 설치되었는지 확인하는 방법

python3 --version

 

아주 간단하죠? 앞에 작성했던 python --version 명령어에 3만 넣어주면 됩니다. 매우 간단하네요 ㅎㅎ

이렇게 입력을 하면 현재 컴퓨터에 파이썬3가 설치되어 있다면 설치된 버전이 뜹니다. 

Python 3.8.9

 

저는 파이썬 3.8.9 버전이 설치되어 있네요. (예전에 파이썬을 설치해 놓은 상태)

 

자, 이제 파이썬3 버전이 설치된 것도 확인했으니 가상환경 venv를 만들 차례입니다.

 

파이썬3 에서 가상환경 만들기

python3 -m venv venvi

 

아까는 python -m 으로 했다면 이번에는 python3을로 명령어를 해 줍니다. 이게 저는 기본적인 파이썬 버전이 2.7버전이라 그렇고 기본버전이 3버전인 분들은 그냥 python -m 명령어를 사용해도 괜찮습니다. 

 

위의 명령어는 "python3에서 venv 가상환경을 만드는데 venvi라는 이름으로 만들어줘" 라는 뜻입니다. venvi 대신에 내가 만들고자 하는 이름을 작성해주면 됩니다. 그런데 저는 이 프로젝트에 상위폴더를 만들어서 그 안에 넣을 예정입니다. 그럼 다시 한번 해볼게요!

 

 

 

 

파이썬에서 상위폴더 만들고 새로운 venv 가상환경 만들기

1. 상위 폴더 만들기

// 윈도우, 맥, 리눅스 동일

mkdir Python

 

Python이라는 폴더를 만들어줍니다. 

 

2. 해당 폴더로 이동

cd Python

 

Python 폴더로 이동합니다. 그럼 터미널 경로에 Python 경로가 추가됩니다. 이동이 된 것이죠. 

 

3. venv 가상환경 만들어주기

python3 -m venv venvi

 

Python 폴더로 이동한 상태에서 venvi라는 이름의 venv 가상환경을 만들어줍니다. 파이썬3 버전을 사용해서요. 그럼 내가 아까 만들어줬던 Python 폴더에 venvi 폴더가 생기면서 가상환경이 만들어집니다!

 

4. venv 가상환경 이름변경

근데 venvi라니 이름이 좀 별로네요. 이름을 바꿔주고 싶습니다.

// 윈도우
ren venvi new_venv

// 맥OS, 리눅스
mv venvi new_venv

 

윈도우에서는 ren을 사용해서, 맥이나 리눅스에서는 mv를 사용해서 폴더명을 변경해줍니다. venvi 라는 이름에서 new_vevn 로 이름을 바꾸라고 명령합니다. 이 때 경로는 상위 경로인 Python 폴더 안에 들어와있는지 확인해야합니다!

 

5. 가상환경 활성화 실행하기

// 윈도우
.\new_venv\Scripts\activate


// 맥OS, 리눅스
source new_venv/bin/activate

 

위와 같은 명령어로 가상환경을 활성화시킵니다. 가상환경이 활성화되어 있어야 설치된 라이브러리 등을 활용할 수 있고 다른 프로젝트와 분리되어 작업할 수 있습니다. 저기서의 new_venv는 내가 만든 venv의 이름입니다. 위와 같이 가상환경을 활성화시키면 터미널에 뜨는 경로옆에 (venv)가 생기게 됩니다. 

 

5-1. 가상환경 비활성화하기

deactivate

 

터미널에 위와 같이 명령어를 입력하면 가상환경이 비활성화되면서 파이썬 전역으로 변경됩니다.