본문으로 건너뛰기

Cursor에서 가상 환경 활성화하기

Python 가상 환경은 프로젝트별로 격리된 개발 환경을 제공합니다. 이 가이드에서는 Cursor IDE에서 가상 환경을 설정하고 활성화하는 방법을 보여드리겠습니다.

가상 환경이란?​

가상 환경은 Python 프로젝트를 위한 격리된 환경으로:

  • 프로젝트별 의존성 관리
  • Python 버전 격리
  • 깨끗한 개발 환경 유지

Cursor에서 가상 환경 설정하기​

1. 새 가상 환경 생성​

터미널에서 다음 명령어를 실행하세요:

# 프로젝트 디렉토리로 이동
cd your-project-directory

# 가상 환경 생성
python -m venv venv

2. 가상 환경 활성화​

운영체제에 따라 다른 명령어를 사용합니다:

# Windows
.\venv\Scripts\activate

# macOS/Linux
source venv/bin/activate

활성화되면 터미널 프롬프트에 (venv)가 표시됩니다.

Cursor에서 가상 환경 사용하기​

1. 통합 터미널 사용​

Cursor의 통합 터미널에서 가상 환경을 활성화할 수 있습니다:

  1. `Ctrl + `` (백틱)을 눌러 터미널 열기
  2. 위의 활성화 명령어 실행

2. Python 인터프리터 선택​

  1. Ctrl + Shift + P를 눌러 명령 팔레트 열기
  2. "Python: Select Interpreter" 입력
  3. 가상 환경의 Python 인터프리터 선택

패키지 관리​

1. 패키지 설치​

활성화된 가상 환경에서:

# pip 업그레이드
pip install --upgrade pip

# 패키지 설치
pip install package-name

# requirements.txt에서 설치
pip install -r requirements.txt

2. 의존성 관리​

# 현재 의존성 내보내기
pip freeze > requirements.txt

# 가상 환경 비활성화
deactivate

모범 사례​

  1. 프로젝트별 가상 환경

    • 각 프로젝트마다 별도의 가상 환경 사용
    • 가상 환경 폴더를 .gitignore에 추가

  2. 의존성 문서화

    • requirements.txt 유지
    • 버전 고정 사용: package==version

  3. 가상 환경 이름 지정

    • 명확한 이름 사용 (예: venv, env, .venv)
    • 프로젝트 구조에 맞게 배치

문제 해결​

1. 가상 환경 활성화 실패​

# Windows에서 실행 정책 확인
Get-ExecutionPolicy
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

2. 패키지 설치 문제​

# pip 캐시 정리
pip cache purge

# 가상 환경 재생성
rm -rf venv
python -m venv venv

3. Python 경로 문제​

# Python 경로 확인
which python  # macOS/Linux
where python  # Windows

고급 설정​

1. 가상 환경 자동 활성화​

Cursor 설정에서 자동 활성화 구성:

  1. settings.json 열기
  2. Python 가상 환경 설정 추가

2. 여러 Python 버전​

# 특정 Python 버전으로 가상 환경 생성
python3.8 -m venv venv-py38
python3.9 -m venv venv-py39

결론​

Cursor에서 가상 환경을 사용하면 Python 개발을 더 효율적이고 격리된 방식으로 할 수 있습니다. 이 가이드의 단계를 따르면 프로젝트 의존성을 효과적으로 관리하고 깨끗한 개발 환경을 유지할 수 있습니다.

추가 리소스:

마지막 업데이트: 2025년 2월 - 이 가이드는 Cursor 버전 0.43 및 Python 3.x를 다룹니다.