[에러#1] “pip가 안 돼요” 해결 체크리스트

한줄 요약:
설치는 했는데 pip가 안 먹는다? 당황 금지!
👉 운영체제·상황별 즉시 체크 포인트로 5분 내 복구하자.

컨텐츠 목차

1. 가장 빠른 응급처치(요거 먼저!)

터미널/명령프롬프트에서 무조건 파이썬을 통해 pip 호출
(직접 pip 치지 말고 “python -m pip” 형태로)

Windows py -m pip --version py -m pip install --upgrade pip py -m pip install <패키지명> py가 없다면: python -m pip --version python -m pip install --upgrade pip
macOS / Linux python3 -m pip --version python3 -m pip install --upgrade pip python3 -m pip install <패키지명>

이렇게 하면 pip 경로/버전 꼬임 문제의 80%가 바로 해결돼요.

증상(메시지)	주요 원인	해결 커맨드/조치
`'pip' is not recognized` (Windows)	PATH에 Scripts 폴더 미포함, 또는 pip 미설치	`py -m ensurepip --upgrade` → `py -m pip install --upgrade pip` / 필요 시 PATH 추가(아래)
`command not found: pip` (macOS)	pip 명령어 링크 없음	`python3 -m ensurepip --upgrade` → `python3 -m pip install --upgrade pip`
`PermissionError` / `권한 거부`	관리자 권한 필요, 시스템 전역 설치	가상환경 사용 권장(아래). 전역 설치 시 Windows는 “관리자 권한 CMD”, macOS는 `--user` 옵션 사용
`SSL: CERTIFICATE_VERIFY_FAILED`	루트 인증서/네트워크 문제	시간 동기화 확인 → macOS: “Install Certificates.command”(파이썬 폴더) 실행 → 프록시/방화벽 점검
`Read timed out` / 다운로드 실패	네트워크/프록시 차단	재시도 `-i https://pypi.org/simple` / 회사망은 프록시 설정(아래)
`No module named pip`	파이썬 내부에 pip 패키지 없음	`python -m ensurepip --upgrade` (또는 `py -m ensurepip --upgrade`)

where pip
where python

C:\Users\<계정>\AppData\Local\Programs\Python\Python3x\
C:\Users\<계정>\AppData\Local\Programs\Python\Python3x\Scripts\

setx PATH "%PATH%;C:\Users\<계정>\AppData\Local\Programs\Python\Python3x;C:\Users\<계정>\AppData\Local\Programs\Python\Python3x\Scripts"

새 터미널을 열고 py -m pip --version으로 확인!

서로 다른 프로젝트의 패키지가 섞여 망가지는 걸 방지해요.

만들기 & 활성화
- Windows py -m venv .venv .venv\Scripts\activate py -m pip install --upgrade pip
- macOS / Linux python3 -m venv .venv source .venv/bin/activate python3 -m pip install --upgrade pip
설치 pip install <패키지명>
비활성화 deactivate

가상환경 안에서는 pip 바로 써도 동일한 파이썬을 가리켜서 안전해요.

Windows
- 가능한 한 py 런처 사용: py --list py -3.12 -m pip install <패키지>
macOS
- python이 2.x일 수 있음 → 반드시 python3 사용
- 홈브류 설치 시 brew install python python3 -m pip install --upgrade pip

회사 네트워크일 경우 프록시 설정이 필요할 수 있어요.

python -m pip install <패키지> --proxy http://ID:PW@proxy.company.com:8080

또는 환경변수:

set HTTPS_PROXY=http://ID:PW@proxy.company.com:8080   # Windows
export HTTPS_PROXY=http://ID:PW@proxy.company.com:8080 # macOS/Linux

Q. pip3와 pip 차이?
A. 보통 pip3는 파이썬3용. 헷갈리면 python3 -m pip를 쓰면 끝.

Q. 관리자 권한이 없어요.
A. --user 옵션으로 사용자 영역에 설치:

python -m pip install --user <패키지명>

Q. 특정 버전 파이썬에만 설치하고 싶어요.
A. 해당 버전으로 명시 실행:

py -3.11 -m pip install <패키지명>

이전 강좌 👈 [자동화#3] CSV 파일 한 번에 합치기
다음 강좌 👉 [에러#2] 한글 깨짐·경로 오류(윈도우/맥 공통 해결 가이드)