pip install로 분명히 설치했는데 ModuleNotFoundError: No module named '...'가 나온다면, 대부분 pip가 설치한 파이썬과 코드를 실행하는 파이썬이 서로 다른 것이 원인입니다. 실행할 파이썬으로 직접 pip를 부르면 해결됩니다.
python -m pip install 패키지이름 # 리눅스·맥은 python3 -m pip
py -m pip install 패키지이름 # 윈도우 py 런처를 쓰는 경우
그래도 안 되면 아래 순서대로 "지금 실행되는 파이썬이 어디 있는지"부터 확인합니다. 이 글의 재현 결과는 2026년 11월 18일 리눅스(우분투 24.04)에서 파이썬 3.12·3.13을 함께 설치한 상태로 직접 실행한 것입니다.
1. 직접 재현: 설치는 됐는데 못 찾는 상황
파이썬 3.12로 가상환경(.venv)을 만들고 그 안의 pip로 pyfiglet을 설치했습니다. 그다음 가상환경을 켜지 않은 채 python3 app.py를 실행했습니다. 이 PC의 python3는 3.13(/usr/local/bin/python3)입니다.
.venv/bin/pip install pyfiglet # 설치 성공
python3 app.py
Traceback (most recent call last):
File "/tmp/mnf/app.py", line 1, in <module>
import pyfiglet
ModuleNotFoundError: No module named 'pyfiglet'
같은 파일을 가상환경의 파이썬으로 실행하면 정상 동작했습니다.
.venv/bin/python app.py # → 정상 출력(글자 그림)
_ |
(_)|<
패키지는 파이썬마다 따로 설치됩니다. 3.12 가상환경에 넣은 것은 3.13이 볼 수 없습니다. "pip는 A 파이썬, 실행은 B 파이썬"이 되면 이 오류가 납니다.
2. 지금 어떤 파이썬이 실행되는지 확인하기
세 가지를 같이 보면 거의 원인이 나옵니다.
python3 -c "import sys; print(sys.executable)"
# /usr/local/bin/python3
python3 --version
# Python 3.13.18
.venv/bin/pip --version
# pip 24.0 from /tmp/mnf/.venv/lib/python3.12/site-packages/pip (python 3.12)
which -a python3
# /usr/local/bin/python3
# /usr/bin/python3
1번 재현 상황에서 실제로 찍은 값입니다. 실행한 파이썬은 3.13인데, 설치에 쓴 pip 줄 끝에는 (python 3.12)가 찍혀 있습니다. which -a로 보면 python3가 여러 곳에 있다는 것도 드러납니다. 이렇게 pip 쪽 파이썬과 실행 쪽 파이썬의 버전이나 경로가 다르면 원인을 찾은 것입니다. 평소에는 .venv/bin/pip 대신 그냥 pip --version을 쳐서 끝의 괄호를 보면 됩니다.
- 리눅스·맥:
which -a python3,which pip - 윈도우 명령 프롬프트:
where python,where pip(PowerShell은where.exe) - 윈도우 py 런처:
py -0p로 설치된 파이썬 목록과 경로 확인
윈도우 명령은 이 글에서 직접 실행하지 않았습니다.
3. 해결: python -m pip로 설치하기
pip라는 명령은 PATH에서 먼저 잡히는 아무 pip나 실행됩니다. python3 -m pip는 "지금 이 python3에 딸린 pip"를 실행하므로 어긋날 일이 없습니다. 실제로 3.13 쪽에 설치하자 같은 app.py가 바로 실행됐습니다.
python3 -m pip install pyfiglet
# Successfully installed pyfiglet-1.0.4
python3 app.py # 정상 출력
python3 -m pip show pyfiglet
# Location: /usr/local/lib/python3.13/site-packages
pip show의 Location이 sys.executable과 같은 파이썬 폴더 아래인지 보면 확실합니다. 다만 리눅스 시스템 파이썬에서는 externally-managed-environment 오류가 날 수 있어, 그 경우는 가상환경을 쓰는 것이 맞습니다.
4. VS Code에서만 안 될 때: 인터프리터 선택
터미널에서는 되는데 VS Code의 실행 버튼(▶)만 오류가 나면, VS Code가 다른 파이썬을 고른 것입니다.
Ctrl+Shift+P(맥은Cmd+Shift+P) → Python: Select Interpreter → 패키지를 설치한 파이썬(예:.venv)을 고릅니다.- 오른쪽 아래 상태 표시줄에 지금 선택된 파이썬 버전이 표시되니 거기서도 바꿀 수 있습니다.
- VS Code 안의 터미널에서
python -m pip install을 하면 선택한 인터프리터와 맞추기 쉽습니다.
VS Code 화면은 이 글에서 직접 확인하지 않았고 공식 문서를 기준으로 적었습니다. 주피터 노트북이라면 커널을 고르는 메뉴가 같은 역할을 합니다.
5. 그 밖에 자주 걸리는 경우
설치 이름과 import 이름이 다름
pip install beautifulsoup4로 설치하고 import beautifulsoup4를 하면 직접 해 봐도 No module named 'beautifulsoup4'가 나왔습니다. 올바른 이름은 import bs4입니다(이건 정상 동작 확인).
| pip install | import |
|---|---|
| beautifulsoup4 | bs4 |
| opencv-python | cv2 |
| Pillow | PIL |
| scikit-learn | sklearn |
| python-dotenv | dotenv |
가상환경을 안 켬
새 터미널을 열면 가상환경은 꺼진 상태입니다. source .venv/bin/activate(윈도우는 .venv\Scripts\activate)를 다시 하거나 .venv/bin/python app.py처럼 경로로 실행합니다.
6. 한 줄 요약
| 확인할 것 | 명령 | 해결 |
|---|---|---|
| 실행되는 파이썬 | python -c "import sys; print(sys.executable)" |
그 파이썬으로 -m pip install |
| pip가 붙은 파이썬 | pip --version |
버전이 다르면 python -m pip 사용 |
| VS Code | Python: Select Interpreter | 설치한 환경 선택 |
| 이름 차이 | pip show 이름 |
import 이름 확인 |
실행 환경: 리눅스(우분투 24.04), 파이썬 3.12.3(가상환경)과 3.13.18. 윈도우 명령과 VS Code 화면은 직접 실행하지 않았습니다. 초안 작성과 검수에 AI를 사용했고, 오류 메시지는 직접 재현해 대조했습니다.
기준일: 2026-11-18
출처
- VS Code – Python environments: https://code.visualstudio.com/docs/python/environments
'개발 오류 해결' 카테고리의 다른 글
| git push rejected (fetch first, non-fast-forward) 해결: pull --rebase와 충돌 처리 (0) | 2026.11.21 |
|---|---|
| git push Permission denied (publickey) 해결: SSH 키·HTTPS (0) | 2026.11.20 |
| pip externally-managed-environment 오류 해결: venv·pipx 정리 (0) | 2026.11.19 |
| 압축 풀면 한글 파일명 깨짐 해결: 맥·윈도우 zip 원인 3가지와 바로 푸는 법 (0) | 2026.11.18 |
| git 한글 파일명 깨짐 해결: 숫자로 나올 때 core.quotepath, 맥 자소 분리까지 (0) | 2026.11.17 |