Python 학습] 가상환경 설정

▣ Python가상환경

파이썬 가상환경은 프로젝트마다 독립된 파이썬 환경과 패키지를 격리하여 관리함으로써, 프로젝트 간의 패키지 버전 충돌을 방지하고 협업 시 환경 불일치 문제를 줄여주며, 전반적인 개발 효율성을 높여주는 필수적인 설정입니다. 

Python 가상환경 설정이 필요한 주요 이유

1. 패키지 의존성 충돌 방지:
   각 프로젝트는 특정 버전의 패키지를 필요로 할 수 있습니다.
   가상환경을 사용하면 A 프로젝트는 A 버전의 패키지를, B 프로젝트는 다른 버전의 패키지를 각각 사용해도 서로 영향을 주지 않고 독립적으로 관리할 수 있어 충돌을 막을 수 있습니다.
    
2. 프로젝트 간 격리:
   시스템의 기본 파이썬 환경과 분리된 독립적인 환경을 제공하여, 시스템의 파이썬 패키지들이 특정 프로젝트에 의해 오염되거나 변형되는 것을 방지합니다. 
   
   
3. 개발 환경 일관성 유지 및 협업 용이성:
   팀원들이 동일한 프로젝트를 작업할 때, 가상환경 설정을 공유하면 모두가 동일한 패키지 버전과 환경을 사용하게 되어 환경 불일치로 인한 문제를 줄이고 협업을 원활하게 할 수 있습니다. 
   
   
4. 환경 관리의 효율성:
   프로젝트별로 필요한 패키지만을 설치하여 전체 개발 환경을 깔끔하게 유지할 수 있습니다. 이는 시스템 자원을 효율적으로 사용하고, 특정 프로젝트에 대한 의존성 관리를 용이하게 합니다. 
   
   
5. 프로젝트 배포의 안정성:
   각 프로젝트에 필요한 패키지 목록을 명확하게 관리할 수 있어, 서버 등 다른 환경에 프로젝트를 배포할 때 필요한 패키지를 정확하게 설치하고 실행하여 안정성을 확보할 수 있습니다

 

[Python] 가상환경의 필요성

 

 

---

▣ VS Code에서 Python 개발 환경 설정

1. 프로그램 다운로드

• Python 설치: Python 공식 웹사이트에서 Python 3.x 버전을 설치. 설치 시 "Add Python to PATH" 옵션을 반드시 체크.
• VS Code 설치: 공식 웹사이트에서 최신 버전을 다운로드하여 설치.

2. Python 확장 설치:

VS Code를 실행한 후, 좌측 사이드바의 Extensions 뷰(네모 아이콘)를 클릭하거나 단축키 Ctrl+Shift+X를 누릅니다.
검색창에 "Python"을 입력하고, Microsoft에서 제공하는 Python 확장을 설치합니다 

Python 확장 설치

 

VS Code에서 Python 확장 프로그램을 설치하는 이유는 다음과 같습니다:

• 파이썬 코드 실행 및 디버깅 지원:
  Python 확장 프로그램은 VS Code에서 .py 파일을 실행하고 디버깅할 수 있는 기능을 제공합니다.
  이를 통해 코드 실행, 중단점 설정, 변수 검사 등을 쉽게 수행할 수 있습니다.
• 인터프리터 관리:
  시스템에 설치된 여러 Python 버전이나 가상 환경을 감지하고 선택할 수 있게 해줍니다.
  이를 통해 프로젝트별로 적합한 Python 환경을 쉽게 설정 가능합니다.
• 코드 완성 및 IntelliSense:
  자동 완성, 함수 정의 미리보기, 변수 제안 등 IntelliSense 기능을 제공해 코딩 효율성을 높입니다.
• 린팅(Linting):
  pylint, flake8 같은 도구를 통합해 코드 품질을 실시간으로 점검하고, 문법 오류나 스타일 위반을 감지합니다.
• 코드 포맷팅:
  black, autopep8 같은 포매터를 지원해 일관된 코드 스타일을 유지할 수 있습니다.
• Jupyter 노트북 통합:
  Python 확장 프로그램은 Jupyter 노트북(.ipynb) 파일 실행과 .py 파일 내에서 Jupyter 셀(# %%) 사용을 지원합니다. 이는 데이터 분석 및 대화형 코딩에 필수적입니다.
• 테스트 프레임워크 지원:
  unittest, pytest 같은 테스트 도구와 통합되어 테스트 실행 및 결과를 VS Code 내에서 확인할 수 있습니다.
• 환경 설정 간소화:
  Python 관련 설정(예: 경로, 환경 변수, 포매터 설정 등)을 VS Code의 UI로 쉽게 관리할 수 있게 해줍니다.

Python 확장 프로그램은 VS Code를 Python 개발에 최적화된 환경으로 만들어주며, 코딩, 디버깅, 분석, 테스트 등 모든 작업을 효율적으로 수행할 수 있게 합니다. 설치하지 않으면 기본 텍스트 편집기로만 동작해 위 기능들을 활용할 수 없습니다.

3단계: 가상 환경(Virtual Environment) 설정: (자주 사용 합니다)

가상 환경은 프로젝트별로 필요한 패키지를 독립적으로 관리하는 데 필수적입니다. 프로젝트를 시작 할때 반드시 정의 하고 사용 합니다.

1. 프로젝트 폴더 열기: VS Code에서 작업할 프로젝트 폴더를 엽니다.

2. 터미널 열기:  Ctrl + Shift + `  를 눌러 VS Code 통합 터미널을 엽니다.

3. 가상 환경 생성: 다음 명령어를 사용하여 가상 환경을 생성합니다.

python -m venv  korea ( korea는 가상 환경이 생성될 폴더의 이름입니다. )

이 명령을 실행하면 현재 작업 중인 디렉터리 안에 korea라는 이름의 새 폴더가 만들어지고, 이 폴더 안에 가상 환경을 구성하는 데 필요한 파일들이 생성됩니다. 예를 들어, 다음과 같은 디렉터리 구조가 만들어집니다.

.
└── my_project/
    └── korea/  <-- 이 폴더 안에 가상 환경이 생성됩니다.

별도의 폴더를 생성 하지 않고 현재의 폴더에 환경 설정 : python -m venv .venv

4. 가상 환경 활성화:

• Windows: .venv\Scripts\activate
• macOS/Linux: source .venv/bin/activate

5. 인터프리터 선택:
VS Code에서 가상 환경이 자동으로 감지되거나, VS Code 하단의 상태 표시줄에 있는 Python 버전 정보를 클릭하여 방금 생성한 가상 환경의 인터프리터를 선택합니다.

가상 환경을 인터프리터로 선택하면 VS Code가 프로젝트의 고유한 Python 환경을 정확히 반영해 
코드 실행, 디버깅, 분석, 포맷팅 등을 일관되게 수행할 수 있습니다. 
선택하지 않으면 시스템 Python이나 잘못된 환경이 사용되어 패키지 누락, 버전 충돌 등의 문제가 발생할 수 있습니다.

1. Command Palette 사용하기
    Ctrl + Shift + P (macOS에서는 Cmd + Shift + P)를 눌러 Command Palette를 엽니다.
2. 검색창에 Python: Select Interpreter를 입력하고 선택합니다.
3. 화면 상단에 인터프리터 목록이 나타나며 여기서 가상 환경의 경로를 선택하면 됩니다.

▣ Python가상환경 구성 동영상

 

---