VScode에서 파이썬 가상환경 설정 방법 기초 가이드

안녕하세요 👋 이번 포스팅에서는 파이썬(Python) 프로그래밍을 위한 개발 환경 중 가장 중요한 단계인
VScode에서 가상환경(Virtual Environment)을 설정하는 방법을 단계별로 알아보겠습니다.

🔹 가상환경이란?

가상환경(Virtual Environment)은 프로젝트별로 독립된 Python 실행 환경을 만드는 기능입니다.
즉, 프로젝트마다 필요한 패키지와 버전을 따로 관리할 수 있게 해주는 시스템이에요.

✅ 가상환경의 장점

• 종속성 관리 : 각 프로젝트마다 필요한 패키지를 독립적으로 관리 가능
• 충돌 방지 : 서로 다른 버전의 라이브러리를 사용하는 프로젝트 간 충돌 방지
• 재현 가능성 : 동일한 환경을 다른 PC나 서버에서도 쉽게 재현 가능

🔹 1. 사전 준비

① 파이썬 설치 확인

먼저 Python이 설치되어 있는지 확인해야 합니다.
터미널(또는 CMD)에서 아래 명령어를 입력합니다.

python --version

또는

python3 --version

버전이 표시되면 정상적으로 설치된 것입니다.
만약 “command not found” 또는 “Python is not recognized”라는 오류가 나타난다면,
파이썬을 설치해야 합니다.

🔹 2. 가상환경 생성

가상환경을 만들기 위해 Python에서 기본 제공하는 venv 모듈을 사용합니다.
이 모듈은 Python 3.3 이상에 기본 포함되어 있어 별도 설치가 필요 없습니다.

명령어

python -m venv 가상환경이름

예를 들어, myenv라는 이름으로 생성하려면 다음과 같습니다

python -m venv myenv

코드 설명

• python : 파이썬 실행 명령어
• -m venv : 가상환경을 생성하는 명령어
• myenv : 생성될 가상환경 폴더 이름 (원하는 이름으로 변경 가능)

💡 VScode 팁
VScode에서 새 터미널을 열면 자동으로 “가상환경을 선택하시겠습니까?”라는 메시지가 나타납니다.
이때 예(Yes)를 클릭하면 자동으로 myenv 환경이 연결됩니다.

🔹 3. 가상환경 활성화

가상환경을 만든 후에는 이를 활성화(activate) 해야 사용 가능합니다.
운영체제별 명령어가 다르니 아래를 참고하세요.

Windows

myenv\Scripts\activate

macOS / Linux

source myenv/bin/activate

 

터미널에 (myenv) 라는 표시가 앞에 붙으면 활성화된 상태입니다.
이제 설치되는 모든 패키지는 이 가상환경 안에서만 적용됩니다.

🔹 4. 가상환경 내에서 작업하기

이제 가상환경이 활성화되었으니, 필요한 라이브러리를 자유롭게 설치할 수 있습니다.

패키지 설치

pip install 패키지이름

 

pip install requests

설치된 패키지 목록 확인

pip list

 

종속성 관리 (requirements.txt)

현재 설치된 모든 패키지를 파일로 저장하려면:

pip freeze > requirements.txt

 

다른 환경(예: 서버, 협업자 PC)에서 같은 패키지를 설치하려면:

pip install -r requirements.txt

 

이 파일을 프로젝트에 포함시켜두면 협업 시 환경 재현이 쉬워집니다.

 

🔹 5. 가상환경 비활성화

작업을 마쳤다면 아래 명령어로 가상환경을 종료할 수 있습니다.

deactivate

 

터미널 프롬프트에서 (myenv) 표시가 사라지면 비활성화된 상태입니다.

🔹 6. 가상환경 삭제

더 이상 필요 없는 가상환경은 폴더 자체를 삭제하면 됩니다.

rm -rf myenv

(Windows에서는 rmdir /s myenv 명령어를 사용할 수 있습니다.)

🔹 가상환경 설정 요약

파이썬 설치 확인

• python --version

가상환경 생성

• python -m venv myenv

가상환경 활성화

• macOS/Linux → source myenv/bin/activate
• Windows → myenv\Scripts\activate

패키지 설치 및 관리

• pip install 패키지명
• pip freeze > requirements.txt

가상환경 비활성화

• deactivate

가상환경 삭제

• rm -rf myenv

✨ 맺음말

가상환경은 파이썬 프로젝트의 “기본기”이자 “문제 해결의 시작점”입니다.
특히 여러 프로젝트를 동시에 운영하거나, 다른 개발자와 협업할 때
패키지 버전 충돌을 방지하는 데 필수적인 도구예요.

이제 VScode에서 가상환경을 직접 만들어
자신만의 안전한 개발 환경을 구성해보세요! 🚀

 

바이낸스 선물 GPT 자동매매 1편 : 기초 개념 & 안전장치