FirstBoot Guides

Python 설치 후 venv 설정 및 패스 문제 가이드

파이썬 설치 후 라이브러리가 꼬여서 고생 중이신가요? 가상 환경 설정과 패스 문제를 해결해 봅시다.

1. 'python' 명령어를 찾을 수 없음

증상: 설치했는데도 명령어를 입력하면 Microsoft Store가 열리거나 오류 발생

원인: 설치 시 "Add Python to PATH" 체크박스를 누락했기 때문입니다.

해결: 설치 프로그램을 다시 실행하여 'Modify'를 선택하고 PATH 등록 옵션을 체크하거나, 직접 환경변수에 경로를 추가하세요.

2. 라이브러리 충돌 (Global vs Local)

증상: pip install을 많이 하다 보니 어느 순간 라이브러리 버전이 꼬여 실행이 안 됨

해결: 모든 프로젝트에 venv(가상 환경)를 생성하여 독립적인 환경을 만드세요.

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

# 가상 환경 활성화 (Windows)
.\venv\Scripts\activate

# 가상 환경 활성화 (macOS/Linux)
source venv/bin/activate

3. pip 속도 저하 문제

해결: 해외 서버망 문제로 pip 설치가 느리다면 국내 미러 사이트(Kakao 등)를 활용하세요.

pip install [패키지명] --index-url https://otter.tistory.com/

1분 확인 커맨드

python --version
pip --version
pip list

관련 가이드