VS Code에서 Python 가상환경 설정하는 방법 (Windows 기준)

(📌 Mac과 Linux에서도 동일한 방식으로 설정 가능)


1️⃣ VS Code에서 Python이 설치되어 있는지 확인

  1. VS Code를 실행합니다.
  2. Ctrl + Shift + P를 눌러 명령 팔레트(Command Palette) 를 엽니다.
  3. Python: Select Interpreter를 검색하여 선택합니다.
  4. 현재 시스템에 설치된 Python 인터프리터 목록이 나타나면, 기본 Python 인터프리터를 선택합니다.

2️⃣ 프로젝트 폴더 생성 및 VS Code에서 열기

  1. 원하는 위치(예: C:\Users\사용자\Documents\MyProject)에 새 폴더를 만듭니다.
  2. VS Code에서 파일 → 폴더 열기를 선택하여 해당 프로젝트 폴더를 엽니다.

3️⃣ 가상환경 생성

(1) VS Code의 터미널 실행

  • Ctrl + ~ (백틱)을 눌러 터미널을 엽니다.
    (또는 상단 메뉴에서 터미널 → 새 터미널 선택)

(2) 가상환경 생성 명령 실행

터미널에서 아래 명령어를 입력하고 실행합니다.

python -m venv venv
  • venv는 가상환경의 폴더 이름으로, 원하는 이름으로 변경할 수도 있습니다. (예: myenv)
  • 실행이 완료되면, 프로젝트 폴더 안에 venv라는 새 폴더가 생성됩니다.

4️⃣ 가상환경 활성화

(1) Windows

venv\Scripts\activate

(폴더 이름이 myenv라면 → myenv\Scripts\activate)

(2) Mac/Linux

source venv/bin/activate

✅ 활성화되면 터미널 앞에 (venv)가 표시됩니다.

(venv) C:\Users\사용자\Documents\MyProject>

5️⃣ VS Code에서 가상환경을 기본 인터프리터로 설정

  1. Ctrl + Shift + P를 눌러 명령 팔레트를 엽니다.
  2. Python: Select Interpreter를 검색하여 선택합니다.
  3. ./venv/Scripts/python.exe (Windows) 또는 ./venv/bin/python (Mac/Linux)을 선택합니다.

6️⃣ 가상환경에서 패키지 설치

가상환경이 활성화된 상태에서 필요한 패키지를 설치할 수 있습니다.

pip install 패키지명

예: requests 패키지 설치

pip install requests

7️⃣ 설치된 패키지 목록 저장

프로젝트를 다른 환경에서도 동일하게 실행하려면 패키지 목록을 저장해야 합니다.

pip freeze > requirements.txt

🚀 나중에 동일한 환경을 설정할 때는 다음 명령어로 한 번에 패키지를 설치할 수 있습니다.

pip install -r requirements.txt

8️⃣ 가상환경 비활성화

작업을 마친 후 가상환경을 비활성화하려면 다음 명령어를 입력합니다.

deactivate

📌 정리: VS Code에서 가상환경 설정하는 전체 과정

1️⃣ Python이 설치되어 있는지 확인
2️⃣ 프로젝트 폴더를 생성하고 VS Code에서 열기
3️⃣ 터미널에서 python -m venv venv로 가상환경 생성
4️⃣ venv\Scripts\activate (Windows) 또는 source venv/bin/activate (Mac/Linux)로 활성화
5️⃣ Ctrl + Shift + PPython: Select Interpreter에서 가상환경 선택
6️⃣ 필요한 패키지 설치 (pip install 패키지명)
7️⃣ pip freeze > requirements.txt로 패키지 목록 저장
8️⃣ deactivate로 가상환경 비활성화

✅ 이렇게 설정하면 프로젝트별로 독립적인 개발 환경을 유지하면서 Python 개발을 할 수 있습니다! 🚀

위로 스크롤