파이썬(Python)

파이썬 가상환경, 매번 만들다 지쳤다면? '황제 가상환경' 세팅법

달마-* 2026. 1. 28. 10:00
반응형

1. 왜 이 짓을 해야 하는가? (고통의 원인)

파이썬 강의를 들으면 항상 첫 단계가 이렇다.

  1. 폴더 만든다.
  2. 가상환경 만든다 (python -m venv...)
  3. 활성화한다.
  4. 라이브러리 깐다 (pip install...)

근데 프로젝트가 day1, day2, project_A... 이렇게 늘어날 때마다 매번 설치하는 건 시간 낭비이자 디스크 낭비다. 그래서 나는 **"내 PC 최상위 경로에 '본부(Master)'를 하나 짓고, 모든 프로젝트가 거기를 끌어다 쓰는 방식"**을 택했다.


2. 황제 가상환경 만들기 (딱 1번만 수행)

Step 1. 위치 선정 가장 찾기 쉽고 절대 지워지지 않을 곳, **C:\Users\내이름 (내 PC 폴더)**로 이동한다. 터미널(CMD/PowerShell)을 열고 아래 명령어로 이동.

Bash
 
cd C:\Users\사용자이름
# (팁: 그냥 터미널 열면 보통 여기서 시작함)

Step 2. 가상환경 생성 이름은 깔끔하게 .env로 짓는다. (앞에 점을 찍으면 숨김 폴더가 되어 깔끔함)

Bash
 
python -m venv .env

Step 3. 필수 재료 채워 넣기 일단 활성화부터 하고, 앞으로 쓸만한 도구들을 한방에 다 설치한다.

Bash
 
# 활성화 (윈도우 기준)
.\.env\Scripts\activate

# (터미널 앞에 (.env) 뜬 거 확인하고!)
# 데이터분석, 크롤링, 웹개발 필수팩 설치
pip install pandas numpy requests beautifulsoup4 streamlit fastapi uvicorn "uvicorn[standard]" openpyxl

3. VS Code에 "여기가 본부다"라고 알리기 (핵심)

이제 VS Code가 어떤 폴더를 열더라도, 알아서 저 .env를 찾아가게 설정해야 한다.

  1. VS Code 실행 후 F1 키 누르기.
  2. Python: Select Interpreter 검색 후 엔터.
  3. 목록에 .env가 안 보일 것임 (너무 상위 폴더라서).
    • Enter interpreter path... 클릭.
    • Find... 클릭.
  4. 탐색기에서 아까 만든 경로 찾아가기:
    • C: > Users > 내이름 > .env > Scripts > python.exe 더블 클릭!

4. 결과 확인 (편안함의 시작)

이제 아무 파이썬 파일이나 열어보자. VS Code 오른쪽 하단 상태 표시줄을 봤을 때 ('.env': venv) 라고 떠 있다면 성공이다.

  • 터미널 자동 적용: Ctrl + J로 터미널을 열면 자동으로 (.env)가 켜진다.
  • 설치 지옥 탈출: 새 프로젝트를 시작해도 pip install 할 필요 없이 바로 코딩하면 된다.

5. 달마의 트러블 슈팅 (에러 잡기)

Q. 터미널을 열었는데 (.env)가 안 떠요.

  • 해결: VS Code는 예전 터미널 화면을 기억하는 습관이 있다. 터미널 창 오른쪽 위의 휴지통(🗑️) 아이콘을 눌러서 끄고, 다시 열면(Ctrl+J) 적용된다.

Q. SecurityError (보안 오류)가 뜨면서 실행이 안 돼요.

  • 해결: 윈도우 PowerShell 권한 문제다. PowerShell을 관리자 권한으로 열고 아래 명령어를 한 번만 쳐주자.(질문 나오면 Y 입력)
  • PowerShell
     
    Set-ExecutionPolicy RemoteSigned
    
반응형