VSCode에서 Python 가상환경(.venv) 설정 및 여러 버전 관리하기

Python 프로젝트를 진행하다 보면, 프로젝트별로 다른 Python 버전과 패키지를 사용하는 경우가 많습니다. 이 글에서는 포터블 버전의 Python과 Visual Studio Code를 활용하여 여러 버전의 Python 가상환경(.venv)을 구성하고 관리하는 방법을 소개합니다.

 

 

 VSCode에서 Python 가상환경(.venv) 설정 및 여러 버전 관리하기

 

목차

1. Python 가상환경이란?

2. 포터블(Portable) Python과 VSCode 설치

3. 프로젝트별 Python 가상환경(.venv)만들기

4. VSCode에서 가상환경 인식하기

5. VSCode에서 가상환경 자동 활성화 설정

6. 프로젝트별 Python 버전 테스트하기

 

추천글

 

 

1. Python 가상환경이란?

Python 가상환경(Virtual Environment)은 프로젝트마다 독립된 Python 실행 환경을 구성하는 기능입니다.
가상환경을 사용하면 시스템 전체에 영향을 주지 않고 프로젝트별로 필요한 패키지를 개별 설치할 수 있습니다.
.venv 폴더에 생성된 가상환경은 해당 프로젝트 전용 Python과 pip을 포함합니다.

가상환경을 사용하면 다음과 같은 장점이 있습니다:

• 서로 다른 프로젝트에서 다른 패키지 버전 사용 가능
• 시스템 전역 Python 환경을 오염시키지 않음
• requirements.txt 파일로 환경을 쉽게 공유 가능

VSCode는 .venv 폴더를 자동으로 감지하여 해당 환경을 기본 Python 인터프리터로 사용합니다.
이를 통해 프로젝트마다 다른 Python 버전 및 라이브러리를 손쉽게 관리할 수 있습니다.

 

 

2. 포터블(Portable) Python과 VSCode 설치

VSCode에서 여러 버전의 Python을 설치하고 프로젝트별로 필요한 Python 버전을 선택하여 환경을 구성해 보겠습니다.

PythonDevelope 디렉터리에 Python(Portable), Visual Studio Code(Portable), 그리고 작업 공간(workspace)을 다음과 같이 구성합니다.

D:\PythonDevelope\
├── Python3.10\
├── Python3.13\
├── VSCode-win32-x64-1.98.2\
└── workspace\
    ├── python-venv-3.10\
    └── python-venv-3.13\

 

◆ VSCode 포터블 설치 요약

1. 공식 사이트에서 ZIP 파일 다운로드
2. 압축 해제 후 data 폴더 생성
3. VSCode 실행 → 설정 변경

Download Visual Studio Code - Mac, Linux, Windows

 

2025.03.25 - [1.시스템&인프라/개발환경] - Visual Studio Code 설치 방법 (Installer / Zip 포터블 모드)

Visual Studio Code 설치 방법 (Installer / Zip 포터블 모드)

 

 

◆ Python 포터블 설치 요약

1. Python 설치 후 폴더 전체 복사
2. 기존 Python 제거
3. 복사본 폴더 이름을 원래 이름으로 변경

2025.03.25 - [1.시스템&인프라/개발환경] - Windows에서 VSCode Portable Python 개발 환경 만들기

Windows에서 VSCode Portable Python 개발 환경 만들기

 

 

3. 프로젝트별 Python 가상환경(.venv) 만들기

1. Python 버전별로 테스트 하기 위해 workspace 아래 다음과 같이 프로젝트 경로가 생성되었는지 확인합니다.

2. File → Open Folder를 선택하여 먼저 Python 3.13 버전용 python-venv-3.13 폴더(프로젝트)를 선택합니다.

3. Ctrl + Shift + P 로 Command Palette.. 선택 후 아래와 같이 가사환경을 설정합니다.

• Python:Select interpreter - Create Virtual Environment - Venv - Enter interpreter path - Find

4. 설정을 완료하면 프로젝트 폴더에 .venv 폴더가  자동 생성이 되며 프로젝트 전용 가상환경 구성이 완료됩니다.

5. 동일한 방법으로 File → Open Folder를 선택하여 Python 3.10 버전용 python-venv-3.10 폴더의 가상환경을 설정합니다.

 

 

4. VSCode에서 가상환경 인식하기

VSCode 를 재시작 하고 잠시 후 Python 가상환경이 활성화 되었다는 메세지 창을 확인 합니다.

Python 확장에서 이제 터미널에서 별도의 활성화 명령어 없이도 자동으로 선택한 가상환경이 활성화 됩니다.

.venv\Scripts\activate 같은 명령어를 직접 실행하여 활성화 해야 할 경우도 있습니다.

 

 

5. VSCode에서 가상환경 자동 활성화 설정

Python 확장에서 자동으로 가상환경이 활성화가 안되는 경우 .venv\Scripts\activate 명령어를 직접 실행하여 활성화 해야 합니다.

 VS설치경로/data/user-data/User/settings.json 파일에 아래 내용을 추가한후 VSCode를 재 실행합니다.

◆ PowserShell용 settings.json 설정

{
  "editor.fontFamily": "D2Coding, Consolas, 'Courier New', monospace",
  "terminal.integrated.env.windows": {
    "PATH": "D:\\PythonDevelope\\Python3.13;D:\\PythonDevelope\\Python3.13\\Scripts;${env:PATH}"
  },
  "terminal.integrated.profiles.windows": {
    "PowerShell": {
      "path": "powershell.exe",
      "args": ["-NoExit", "-Command", "& .venv\\Scripts\\Activate"]
    }
  },
  "terminal.integrated.defaultProfile.windows": "PowerShell"
}

 

◆ CMD(Command Prompt)용 settings.json 설정

{
  "editor.fontFamily": "D2Coding, Consolas, 'Courier New', monospace",
  "terminal.integrated.env.windows": {
    "PATH": "D:\\PythonDevelope\\Python3.13;D:\\PythonDevelope\\Python3.13\\Scripts;${env:PATH}"
  },
  "terminal.integrated.profiles.windows": {
    "Command Prompt": {
      "path": "cmd.exe",
      "args": ["/k", ".venv\\Scripts\\activate"]
    }
  },
  "terminal.integrated.defaultProfile.windows": "Command Prompt"
}

 

 

6. 프로젝트별 Python 버전 테스트 하기

3.10 프로젝트에서는 Python 3.10이, 3.13 프로젝트에서는 Python 3.13이 출력되어야 정상 설정입니다.

 

 

이번 글에서는 VSCode에서 Python 가상환경(.venv) 을 설정하고, 여러 버전의 Python을 프로젝트별로 관리하는 방법을 소개했습니다.
포터블 환경을 활용하여 시스템 환경에 영향을 주지 않고 독립적이고 유연한 개발환경 구성이 가능합니다.

 

 

추천글

• 2025.03.25 - [1.시스템&인프라/개발환경] - Visual Studio Code 설치 방법 (Installer / Zip 포터블 모드)

Visual Studio Code 설치 방법 (Installer / Zip 포터블 모드)

• 2025.03.25 - [1.시스템&인프라/개발환경] - Windows에서 VSCode Portable Python 개발 환경 만들기

Windows에서 VSCode Portable Python 개발 환경 만들기

• https://velog.io/@tngus0325/%ED%8C%8C%EC%9D%B4%EC%8D%AC-%EA%B0%80%EC%83%81%ED%99%98%EA%B2%BD-Conda%EC%99%80-Venv%EC%9D%98-%EC%9D%B4%ED%95%B4

파이썬 가상환경: Conda와 Venv의 이해

• https://homubee.tistory.com/38

[Python] 파이썬 가상환경(venv) 종류 및 사용법 정리