ModuleNotFoundError: No module named '~~~' 해결법(파이썬에서 모듈을 찾지 못할 때)

안녕하세요.

이번 시간에는 Python에서 모듈을 찾지 못할 때 발생하는

ModuleNotFoundError의 해결 방법에 대하여 간략하게 정리해보도록 하겠습니다.

 

 

1. __init__.py 파일이 포함되었는지 확인

모듈 구조를 제대로 인식하기 위해서는 __init__.py이 모든 경로마다 포함되어 있어야 합니다.

초기화할 내용이 없더라도 반드시 빈 파일이라도 포함되는 것이 필요합니다.

/root/my_module/
└── my_module/
    ├── __init__.py      # 루트 모듈 위치에서의 __init__.py
    ├── my_sub_module/
    │   ├── __init__.py  # 서브 모듈 위치에서의 __init__.py
    │   ├── aaa.py
    │   └── bbb.py
    └── ...              # 기타 모듈들(모든 위치에서 __init__.py 필수)

 

 

2. python -m 명령어로 실행 시도

__init__.py가 올바르게 포함이 되었는데도 에러가 발생한다면

다음과 같이 python -m 명령어로 시도해보면 도움이 될 수 있습니다.

 

예를 들어,

python my_module/my_sub_module/aaa.py

라는 방식으로 실행을 하는데 오류가 발생한다면,

python -m my_module.my_sub_module.aaa

와 같은 방식으로 명령어를 바꿔서 실행해주시면 됩니다.

 

위의 방법들이 문제 해결에 도움이 되셨기를 기원하겠습니다.

잘 봐주셔서 감사드립니다.