AI 코딩/오류 읽기 시리즈

AI 코딩할 때 꼭 알아야 할 오류 읽는 법 : ModuleNotFoundError

togchae 2026. 4. 24. 09:30

AI에게 코드를 받아서 그대로 실행했는데, 이상한 오류가 나올 때가 있습니다.

오류가 생기지 않을만한 짧은 테스트용 코드인데도 말이죠.

 

예시 코드 바로 보겠습니다.

# ModuleNotFoundError

import requests

response = requests.get("https://example.com")
print(response.status_code)

이번에는 example.com이라는 페이지에 get 요청을 보내서

status_code를 살펴보려고 코드를 부탁해보았습니다.

 

실행을 해보면,

'requests'라는 모듈은 없는거라고 나옵니다.

AI가 우리한테 없는 걸 있다고 거짓말을 한걸까요? 자주 그러잖아요.

 

ModuleNotFoundError는

사용하려는 모듈이 현재 Python 환경에 설치되어 있지 않으면 발생합니다.

 

requests는 API를 활용할 때 주로 사용하는 '외부' 라이브러리입니다.

파이썬 환경을 처음 구축할 때 같이 설치가 되지 않는 종류라고 보시면 됩니다.

 

이 경우에는 가상환경을 사용중이시고 가상환경에서만 사용할 예정이라면 가상환경 터미널에서

아니면 그냥 일반 터미널에서 명령어를 사용해서 필요한 모듈을 설치해주시면 됩니다.

pip install requests
python -m pip install requests

2가지 명령어가 있는데요.

동일한 작동을 하지만 환경에 따라 작동하지 않는 경우도 있어서 모두 소개해드렸습니다.

 

설치를 완료하시고 코드를 실행해보면

이처럼 숫자가 출력되면 성공입니다.

 

ModuleNotFoundError는 어디서부터 확인하면 좋을까요?

1. import를 한 모듈 이름을 정확하게 쳤는지

2. 해당 모듈이 실제로 설치되어 있는지

3. pip install을 현재 사용하는 Python 환경에 했는지

4. VS Code나 터미널에서 올바른 Python 인터프리터를 선택했는지

 

이제 컴퓨터에서 다양한 프로젝트를 진행하시면 가상 환경을 사용하시거나

Python 환경 자체도 여러가지로 나눠서 활용하시는 경우가 생기게 되는데요.

이 환경에 무슨 모듈을 설치했었는지 기억이 안나는 경우가 많습니다.

그럴땐 간단하게 명령어로 무슨 모듈이 설치되어있는지 확인하실 수 있습니다.

pip list

이 명령어를 터미널에 작성하시고 실행시키시면,

현재 이 환경에 무슨 모듈이 설치가 되어있는지 바로 출력이 됩니다.

 

이번에는 코드보다는 환경과 설치의 문제로 발생하는 오류에 대해서 읽어보았습니다.

다음에도 유익한 오류 읽는 법으로 돌아오겠습니다.