pip 초보 탈출: 패키지 설치/삭제/목록/업그레이드까지 – Python Venv Setup 3편

2편에서 파이썬 가상환경(Python Venv) 중 “내 파이썬이 어디 있는지”를 증거로 확인했죠.
그 다음 초보자가 제일 많이 부딪히는 벽은 이겁니다.

“파이썬은 있는데, 유용한 기능은 다 ‘패키지’를 설치해야 하네?”

맞아요. 현실의 파이썬은 기본 설치만으로는 할 수 있는 게 제한적이고, 우리가 흔히 쓰는 데이터 분석/웹 개발/자동화는 대부분 외부 패키지에서 시작합니다.

그리고 그 패키지들을 설치/삭제/관리해주는 도구가 바로 pip예요.
오늘 편은 딱 이렇게 느끼는 게 목표입니다.

“아… pip는 그냥 ‘파이썬 앱스토어 설치기’ 같은 거구나.”

Python Venv 관련 오늘 목표(핵심 4개)

1. 내 pip가 어느 파이썬에 붙어 있는지 확인하기
2. pip 업그레이드 하기
3. 패키지 설치/버전 고정 설치/삭제 하기
4. 설치된 패키지 목록 확인하기

pip를 안전하게 쓰는 습관

초보자는 pip3 / pip / python3가 섞이면서 혼란이 와요.
그래서 저는 한 가지 습관을 강력 추천합니다.

• Mac: python3 -m pip ...
• Windows: py -m pip ...

이 방식은 “지금 내가 쓰는 파이썬에 딸린 pip”를 정확히 호출해줘서, 버전 꼬임이 훨씬 줄어듭니다.

1) Mac: pip 기본기 (확인 → 업그레이드 → 설치/삭제 → 목록)

Step 1. pip가 붙은 파이썬/버전부터 확인

터미널에서 아래를 순서대로 실행해보세요.

python3 --version
python3 -m pip --version

#출력예시
Python 3.14.2
pip 25.3 from /opt/homebrew/lib/python3.14/site-packages/pip (python 3.14)

• 첫 줄은 “파이썬 버전”
• 둘째 줄은 “pip 버전 + pip가 설치된 위치”가 같이 나옵니다

여기서 pip 위치 경로가 나온다는 게 은근히 중요해요.
나중에 “왜 설치가 안 되지?” 할 때, 진짜 원인을 잡아주는 단서가 됩니다.

Step 2. pip 업그레이드(맥 Homebrew 환경)

이제 pip를 최신으로 올려봅시다.

# 프로젝트 폴더 생성후 그곳으로 이동해서 가상환경 생성부터!
mkdir myproject && cd myproject
python3 -m venv venv
source venv/bin/activate
pip install --upgrade pip 

업그레이드는 “당장 필요한 기능”이라기보다, 설치 에러를 줄이는 보험 같은 느낌이에요.

Step 3. 패키지 설치(기본)

예를 들어 numpy 설치를 한다면:

# 생성한 가상환경에서
python3 -m pip install numpy

설치가 끝나면, “진짜 설치됐나?” 확인은 이렇게 합니다.

python3 -m pip show numpy

Step 4. 특정 버전으로 설치(버전 고정)

패키지를 설치할 때 “딱 이 버전”이 필요할 때가 있어요. 그럴때는 아래처럼 하면 됩니다.

python3 -m pip install numpy==1.20.1

이게 왜 중요하냐면, 강의/교재/회사 프로젝트는 “돌아가는 조합”이 이미 정해져 있는 경우가 많거든요.
그 조합을 맞추는 가장 확실한 방법이 버전 고정 설치입니다.

Step 5. 패키지 삭제

python3 -m pip uninstall some_package

삭제할 때는 보통 “정말 지울까요?”를 물어보는데, y 누르면 됩니다.

Step 6. 설치된 패키지 목록 보기

python3 -m pip list

여기서 패키지들이 쭉 나오면 성공이에요.
“내 환경에 뭐가 깔려 있지?”를 볼 수 있는 가장 쉬운 방법입니다.

2) Windows: pip 기본기 (where/py → 업그레이드 → 설치/삭제 → 목록)

Windows는 2편에서 말했듯이 python보다 py가 깔끔한 경우가 많아서, 이번 편도 py -m pip 기준으로 갈게요.

Step 1. 파이썬/ pip 버전 확인

PowerShell 또는 CMD에서

py --version
py -m pip --version

여기서도 pip 버전과 경로가 함께 출력됩니다.
초보자에게는 이게 “내가 지금 어떤 pip를 쓰는지” 확인하는 가장 쉬운 방법이에요.

Step 2. pip 업그레이드

py -m pip install --upgrade pip

사실 이 부분은 크게 신경쓰지 않아도 되는게 가상환경 생성시에 업그레이드가 필요하면 알려줍니다. 그 때 그대로 따라하면 됩니다.

Step 3. 패키지 설치(기본)

py -m pip install numpy
py -m pip show numpy

Step 4. 특정 버전으로 설치(버전 고정)

py -m pip install numpy==1.20.1

Step 5. 패키지 삭제

py -m pip uninstall some_package

Step 6. 설치된 패키지 목록 보기

py -m pip list

3) 초보자들이 가장 많이 겪는 상황 3가지

(1) “pip가 없대요 / 명령을 찾을 수 없대요”

• Mac: pip3가 안 되면 python3 -m pip로 먼저 시도해보세요.
• Windows: pip가 안 되면 py -m pip로 가는 게 안정적입니다.

(2) “Permission denied / 권한이 없대요”

이건 보통 “전역 환경에 설치하려고 해서” 생겨요.
해결 방향은 두 가지입니다.

• (임시) --user 옵션으로 사용자 영역에 설치
• (추천) 다음 편에서 배울 가상환경(virtualenv) 로 프로젝트별 분리

가상환경을 쓰면 이런 권한 문제도, 패키지 꼬임도 훨씬 줄어듭니다.

(3) “설치는 됐는데 import가 안 돼요”

이건 거의 항상 “설치한 파이썬”과 “실행한 파이썬”이 다른 경우예요.
그래서 오늘 내내 python3 -m pip, py -m pip를 강조한 겁니다.

4) 오늘의 미니 퀴즈(가볍게 점검)

Q1) numpy를 특정 버전(1.20.1)으로 설치하는 명령은?

• Mac: python3 -m pip install numpy==1.20.1
• Windows: py -m pip install numpy==1.20.1

Q2) 설치된 패키지 목록 확인 명령은?

• Mac: python3 -m pip list
• Windows: py -m pip list

오늘의 체크리스트(이거만 되면 3편 끝)

Mac

• python3 -m pip --version 출력 확인
• python3 -m pip install --upgrade pip 실행
• python3 -m pip install numpy==1.20.1 실행
• python3 -m pip list에서 numpy가 보임

Windows

• py -m pip --version 출력 확인
• py -m pip install --upgrade pip 실행
• py -m pip install numpy==1.20.1 실행
• py -m pip list에서 numpy가 보임

마무리: pip까지 되면, 이제 “프로젝트”를 만들 준비가 됐어요

오늘은 pip를 “설치 버튼”처럼 쓰는 법을 몸에 익혔습니다.
여기까지 왔다면, 이제 파이썬 환경은 단순히 설치된 상태가 아니라 내가 관리할 수 있는 상태가 된 거예요.

다음 포스트 내용은 조금 재미?가 있을꺼예요.
왜 실행할 때마다 __pycache__가 생기는지, “인터프리터가 내부에서 무슨 일을 하는지”를 너무 어렵지 않게, 그런데 이해되게 풀어드릴게요.