파이썬 pip 설치 오류 해결 7가지 — 맥·윈도우 초보용

파이썬 pip 설치 오류는 파이썬 자체보다 경로(PATH), 권한, 버전 충돌 때문에 생기는 경우가 대부분입니다. 이 글은 맥과 윈도우에서 pip install 명령이 안 먹힐 때 어떤 순서로 확인하고 고쳐야 하는지 초보자용으로 정리했습니다.

처음 파이썬을 깔고 예제 코드를 따라 하다 보면, 두 번째 줄부터 빨간 글씨가 쏟아지는 순간이 옵니다. 저도 예전에 새 노트북에 파이썬을 설치하고 pip install requests 한 줄 넣었다가 'pip' is not recognized를 보고 30분 동안 검색만 했던 기억이 있습니다.

오류 메시지가 겁을 줄 뿐, 원인은 대부분 뻔합니다. 재설치를 반복하면 오히려 꼬입니다. 아래 순서대로 하나씩 확인해 보세요.

pip이 뭐고 왜 오류가 나는지

pip은 파이썬용 앱스토어 같은 도구입니다. 정확히는 파이썬 라이브러리(다른 사람이 미리 만들어 둔 코드 묶음)를 인터넷에서 내려받아 설치해 주는 프로그램입니다.

예를 들어 엑셀 파일을 파이썬으로 다루고 싶다면 pip install openpyxl 한 줄로 관련 도구가 깔립니다. 이게 안 되면 그다음 아무것도 못 합니다.

오류가 나는 이유는 대략 이 4가지 안에 있습니다.

원인	증상 예시	빈도
PATH(경로) 미설정	'pip' is not recognized, command not found	매우 높음
파이썬·pip 버전 불일치	No module named pip	중간
권한 부족	Permission denied, Access is denied	중간
네트워크·프록시 문제	Could not fetch URL, SSL error	낮음

이 표에서 위 두 번째 줄까지가 초보자가 만나는 오류의 80% 이상을 차지합니다. 아래 7가지 해결법도 같은 순서로 나열했습니다.

1. 파이썬이 제대로 깔렸는지부터 확인

pip은 파이썬을 설치할 때 같이 딸려오는 도구입니다. 그래서 pip이 안 되면 먼저 파이썬 본체가 잘 있는지 확인해야 합니다.

터미널(검은 화면에 명령어를 입력하는 프로그램. 맥은 "터미널" 앱, 윈도우는 "PowerShell" 또는 "명령 프롬프트")을 열고 다음을 입력합니다.

python --version

이 명령은 "설치된 파이썬 버전을 알려줘"라는 뜻입니다. Python 3.11.5 같은 문구가 나오면 정상입니다.

아무 반응이 없거나 command not found가 뜨면 파이썬 자체가 안 깔렸거나 경로가 안 잡힌 상태입니다. 이럴 땐 python.org 공식 사이트에서 최신 3.x 버전을 다시 받는 게 제일 빠릅니다.

💡 윈도우에서 파이썬을 재설치할 때는 첫 화면의 "Add python.exe to PATH" 체크박스를 반드시 켜세요. 이걸 놓치면 이 글의 대부분 오류가 다시 발생합니다.

2. pip 대신 python -m pip 써보기

pip 명령이 안 되면 대안 명령이 하나 있습니다. 실제로 가장 빠른 우회로입니다.

python -m pip install 패키지이름

이 명령은 "파이썬을 실행시켜서 그 안에 들어있는 pip 모듈을 써라"라는 뜻입니다. 경로가 꼬여 있어도 파이썬만 잡히면 동작합니다.

저는 새 컴퓨터를 세팅할 때 아예 이 방식만 씁니다. 오류 확률이 훨씬 낮거든요. 만약 python -m pip도 안 먹히면 아래 3번으로 넘어갑니다.

3. python 대신 python3 (특히 맥)

맥 사용자가 가장 자주 걸리는 함정입니다. 맥에는 시스템용 파이썬 2.7이 예전부터 깔려 있어서, 그냥 python이라고 치면 옛날 버전이 실행됩니다.

맥에서는 이렇게 써야 합니다.

python3 --version
python3 -m pip install 패키지이름

python3로 하니 갑자기 됐다면, 이제부터 습관적으로 python3, pip3를 쓰면 됩니다.

윈도우는 반대로 python이 표준입니다. 두 OS의 관습이 달라서 검색으로 나오는 예제를 그대로 따라 하면 이 지점에서 자주 막힙니다.

4. PATH 문제 잡기 (윈도우 'pip' is not recognized)

윈도우에서 가장 흔한 오류가 이겁니다.

'pip' is not recognized as an internal or external command

이 메시지는 "pip이라는 프로그램을 어디서 찾아야 할지 모르겠다"는 뜻입니다. 파이썬은 깔렸지만 컴퓨터가 그 위치를 모르는 상태죠.

가장 안전한 해결법은 파이썬을 다시 설치하는 겁니다. 재설치라고 하면 부담스럽지만 아래 순서면 5분 안에 끝납니다.

• [ ] 제어판 → 앱 → Python 제거
• [ ] python.org에서 최신 3.x 설치 파일 다운로드
• [ ] 설치 시작 화면에서 "Add python.exe to PATH" 체크 ⭕
• [ ] "Install Now" 클릭
• [ ] 설치 후 터미널 새 창을 열고 pip --version 확인

이미 파이썬을 지우고 싶지 않다면, 시작 메뉴에서 "시스템 환경 변수 편집"을 검색해 PATH에 파이썬 설치 폴더(예: C:\Users\사용자명\AppData\Local\Programs\Python\Python311\Scripts)를 수동으로 추가하는 방법도 있습니다. 다만 초보자에겐 재설치가 훨씬 안전합니다.

5. No module named pip — pip 자체가 빠진 경우

파이썬은 있는데 pip 모듈만 빠져 있는 특이 케이스입니다. 리눅스나 회사에서 배포한 파이썬을 쓸 때 종종 나옵니다.

이럴 땐 pip을 직접 설치하는 명령이 있습니다.

python -m ensurepip --upgrade

ensurepip은 "pip이 없으면 자동으로 깔아줘"라는 파이썬 내장 기능입니다. 이걸로 해결이 안 되면 아래 명령으로 강제 설치도 가능합니다.

python -m ensurepip --default-pip
python -m pip install --upgrade pip

두 번째 줄은 pip 자체를 최신 버전으로 올리는 명령입니다. 오래된 pip은 그 자체로 SSL 오류를 자주 일으키니 한 번쯤 업그레이드해 두면 좋습니다.

6. 권한 오류 (Permission denied)

pip install을 했더니 파일을 못 쓴다는 오류가 나오는 경우입니다. 컴퓨터가 "여기에 뭘 설치할 권한이 없다"고 거부하는 상태입니다.

가장 흔한 해결책 두 가지를 소개합니다.

pip install --user 패키지이름

--user 옵션은 "시스템 전체가 아니라 내 계정 폴더에만 설치해 줘"라는 뜻입니다. 관리자 권한 없이도 대부분 잘 동작합니다.

더 근본적인 해결법은 가상환경(virtual environment) 을 쓰는 겁니다. 가상환경은 프로젝트마다 별도의 파이썬 놀이터를 만들어 주는 도구라고 생각하면 됩니다. A 프로젝트에 설치한 라이브러리가 B 프로젝트에 영향 주지 않게 격리해 줍니다.

python -m venv myenv

이 명령은 "myenv라는 이름의 격리 공간을 만들어라"라는 뜻입니다. 만든 뒤 아래 명령으로 그 공간에 들어갑니다.

OS	가상환경 활성화 명령
맥 · 리눅스	source myenv/bin/activate
윈도우 (PowerShell)	myenv\Scripts\Activate.ps1
윈도우 (cmd)	myenv\Scripts\activate.bat

활성화되면 프롬프트 앞에 (myenv)가 붙습니다. 이 상태에서 pip install을 하면 권한 문제가 거의 안 생깁니다. 저는 실무에서도 무조건 이 방식을 씁니다.

7. SSL·네트워크 오류

Could not fetch URL, SSL: CERTIFICATE_VERIFY_FAILED 같은 문구가 뜨면 인터넷 연결이나 보안 인증서 문제입니다.

카페나 회사 네트워크에서 자주 나옵니다. 임시로 이렇게 우회할 수 있습니다.

pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org 패키지이름

pypi.org는 파이썬 라이브러리 저장소(파이썬 앱스토어의 실제 서버 주소)이고, 위 옵션은 "이 두 주소는 안전하다고 신뢰해줘"라는 뜻입니다.

다만 이건 임시방편입니다. 회사 네트워크라면 프록시 설정이 따로 필요할 수 있으니 사내 IT팀에 문의하는 게 정석입니다. 집에서 이 오류가 나오면 백신 프로그램이나 방화벽을 잠깐 꺼보는 것도 방법입니다.

흐름 정리 — 순서대로 확인하기

7가지가 많아 보이지만 결국 아래 흐름 하나입니다.

pip 오류 발생
    ↓
① python --version 으로 파이썬 확인
    ↓ (안 되면 재설치)
② python -m pip 로 우회 시도
    ↓ (맥이면 python3 -m pip)
③ 여전히 안 됨 → PATH 재설정 (윈도우 재설치)
    ↓
④ No module named pip → ensurepip
    ↓
⑤ Permission denied → --user 또는 venv
    ↓
⑥ SSL 오류 → --trusted-host

저도 처음엔 이 순서를 몰라서 무작정 재설치만 반복했는데, 사실 대부분은 2번(python -m pip)이나 3번(맥에서 python3)에서 해결됩니다.

자주 막히는 부분

터미널을 새로 안 열었다 — 파이썬을 새로 설치하거나 PATH를 바꾸고 나서 기존에 열려 있던 터미널 창에서 계속 시도하면 반영이 안 됩니다. 반드시 창을 닫고 새로 여세요. 저도 이걸로 15분을 날린 적 있습니다.

설치는 됐는데 파이썬에서 import가 안 된다 — pip install이 성공했는데도 코드에서 ModuleNotFoundError가 뜨면, pip과 파이썬이 서로 다른 버전을 가리키는 상태입니다. python -m pip install로 다시 설치하면 대부분 해결됩니다.

macOS의 externally-managed-environment 오류 — 최근 맥 파이썬(3.11 이후)은 시스템 보호를 위해 전역 설치를 막습니다. 이때는 위 6번의 가상환경(python3 -m venv)이 사실상 유일한 답입니다. --break-system-packages 옵션이 있긴 하지만 시스템이 꼬일 수 있어 초보자에겐 권하지 않습니다.

설치가 너무 느리다 — 국내에서는 카카오 미러 같은 국내 저장소를 쓰면 훨씬 빠릅니다. 다만 초보자에겐 굳이 필요 없고, 라이브러리 하나 받는 데 1~2분 정도는 정상 범위입니다.

마무리

pip 오류는 무섭게 보이지만 원인은 대부분 경로, 권한, 버전 이 셋 안에 있습니다. 특히 맥이면 python3, 윈도우면 재설치할 때 PATH 체크, 이 두 가지만 기억해도 절반은 끝납니다.

다음에 오류를 만나면 재설치부터 하지 말고 python -m pip --version 한 줄로 상태부터 확인해 보세요. 그리고 앞으로 파이썬을 자주 쓸 계획이라면 이번 기회에 가상환경(venv) 사용법을 익혀 두는 걸 추천합니다. 나중에 라이브러리가 꼬여 밤새 삽질하는 일을 확실히 줄여 줍니다.

본 글은 파이썬 3.11 및 공식 문서(python.org) 기준으로 작성되었습니다.

함께 보면 좋은 글

• Zig 언어가 뭔가요 — Rust 다음 후보 5분 정리
• Go 5분 입문 — 왜 백엔드는 자꾸 Go로 가나
• Python 5분 입문 — 비개발자 첫 코드 가이드