ImportError: No module named の原因と解決策

概要

ImportError: No module named は、Python でモジュールをインポートしようとしたが、そのモジュールが見つからない場合に発生するエラーです。Python 3.6 以降では ModuleNotFoundError としても表示されます。

エラーメッセージ

ImportError: No module named 'requests'

ModuleNotFoundError: No module named 'pandas'

原因

パッケージ未インストール: 必要なパッケージがインストールされていない
仮想環境の問題: 別の仮想環境にインストールされている
Python バージョンの不一致: pip と python のバージョンが異なる
パス設定の問題: PYTHONPATH にモジュールのパスが含まれていない
モジュール名の誤り: タイプミスや大文字小文字の間違い

解決策

1. パッケージをインストール

1
2
3
4
5
6
7
8
# pip でインストール
pip install requests

# pip3 を明示的に使用
pip3 install requests

# 特定の Python バージョン向け
python3 -m pip install requests

2. 仮想環境を確認

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
# 現在の Python パスを確認
which python
which pip

# 仮想環境を有効化
source venv/bin/activate  # Linux/macOS
.\venv\Scripts\activate   # Windows

# インストール済みパッケージを確認
pip list

3. requirements.txt から一括インストール

1
2
3
4
5
# requirements.txt を作成
pip freeze > requirements.txt

# 他の環境で再現
pip install -r requirements.txt

4. パスを確認・追加

1
2
3
4
5
6
7
import sys

# 現在のパスを確認
print(sys.path)

# パスを追加
sys.path.append('/path/to/your/module')

5. ローカルモジュールのインポート

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
# プロジェクト構造
# myproject/
#   ├── main.py
#   └── utils/
#       └── helper.py

# main.py から helper をインポート
from utils.helper import my_function

# または
from utils import helper
helper.my_function()

概要

エラーメッセージ

原因

解決策

1. パッケージをインストール

2. 仮想環境を確認

3. requirements.txt から一括インストール

4. パスを確認・追加

5. ローカルモジュールのインポート

Python の他のエラー