[Python] vscode 인터프리터와 가상환경 설정 (Error 피하는 방법)

이번 글에서는 Python 3.9.0을 설치하고, 가상환경을 설정하여 VSCode에서 사용하는 방법을 설명하겠습니다.
또한, 인터프리터 Error를 피하는 방법도 함께 소개합니다.

Python을 사용하여 Django와 같은 프레임워크를 공부하거나 프로젝트를 진행할 때, 가상환경(venv)을 사용하면 여러 버전의 Python과 패키지를 관리하기 용이합니다.

 

VSCode를 이용해서 Python을 다룰 일이 많은데 항상 같은 버전을 사용하지 못할 때가 자주 발생하기에 가상환경을 만들 일이 많이 생깁니다.
이 과정에서 예기치 못한 이슈가 자주 발생하여 정리 차원에서 작성합니다.

1. Python 3.9.0 설치

Windows

1. Python 3.9.0 다운로드 페이지로 이동합니다.
2. Windows용 설치 파일을 다운로드하고 실행합니다.

MacOS

1. Homebrew를 사용하여 Python 3.9.0을 설치합니다. 
2. brew install python@3.9

Linux

1. 패키지 관리자를 통해 Python 3.9.0을 설치합니다.

    sudo apt-get update
    sudo apt-get install python3.9 python3.9-venv python3.9-dev

2. 가상환경(venv) 만들기

Python 3.9.0 설치가 완료되면 가상환경을 설정합니다.

1. 터미널(혹은 CMD)을 열고, 가상환경을 만들 디렉토리로 이동합니다.
2. 다음 명령어로 가상환경을 생성합니다.

    python -m venv myenv

3. ★가상 환경을 생성하였을 땐 대부분 Global로 설정된 Python 버전이 적용된 가상환경이 발생할 확률이 높습니다.
   따라서 우리는 원하는 파이썬 버젼을 이용하기 위해서 가상환경의 configuration을 수정해야합니다.
   가상환경을 생성하면 현재 위치에 가상환경 이름의 폴더(myenv)가 생성이 됩니다.
   폴더 하위에 있는 pyvenv.cfg에 "home"과 "version"을 사용하려는 version의 python.exe가 있는 폴더경로와 적절한 version으로 수정해줘야합니다.

   home = C:\Users\shongstudio\AppData\Local\Programs\Python\Python39
   include-system-site-packages = false
   version = 3.9.0

3. 가상환경 활성화

가상환경을 활성화하여 해당 환경에서 Python을 사용할 수 있도록 설정합니다.

Windows

```sh
myenv\Scripts\activate
```

MacOS/Linux

```sh
source myenv/bin/activate
```

4. 가상환경 비활성화

작업이 끝난 후 가상환경을 비활성화합니다.
sh deactivate

5. VSCode에서 가상환경 설정

1. VSCode를 열고 Ctrl+Shift+P를 눌러 명령 팔레트를 엽니다.
2. "Python: Select Interpreter"를 검색하고 선택합니다.
3. 생성한 가상환경을 선택합니다. (예: myenv)
4. ※주의 가상환경을 activate하고, 가상환경의 python Interpreter를 선택했을 때 우측 하단의 python version이 동기화가 안되었을 수 있습니다. (python --version 을 이용해서 확인되는 version을 믿으시면 됩니다.)

6. 인터프리터 Error 피하는 방법

위에서 설명했지만 다시한번 강조드립니다.
가상환경을 만들었을 때, env 폴더 내의 pyvenv.cfg 파일을 수정하여 인터프리터 Error를 피할 수 있습니다.

1. myenv 폴더 내의 pyvenv.cfg 파일을 엽니다.
2. home과 version 값을 우리가 설치한 Python 3.9.0의 경로와 버전으로 맞춥니다. 예시:

    home = C:\Users\YourUsername\AppData\Local\Programs\Python\Python39
    version = 3.9.0

마무리

이제 Python 3.9.0을 사용하여 가상환경을 만들고, VSCode에서 이를 설정하는 방법을 알게 되었습니다. 이 설정을 통해 프로젝트마다 독립적인 Python 환경을 유지할 수 있으며, 인터프리터 Error를 피할 수 있습니다.