できない.dev

Python import できない(ModuleNotFoundError)

ModuleNotFoundError は「使っている Python と pip install 先が別」「PYTHONPATH の通っていないディレクトリ」「相対 import の記法ミス」のいずれかが原因。

公開: 更新:

症状できない · exit 1
python app.py
Traceback (most recent call last):
  File "/tmp/tmp.M9CRszfMS3/app.py", line 1, in <module>
    import requests
ModuleNotFoundError: No module named 'requests'
解決後できた · exit 0
python app.py
requests version: 2.31.0

2026-08-02 に python:3.12 で実際に打って取った出力。検証環境の詳細

要約

ModuleNotFoundError: No module named 'X' の解決は、まず python -m pip install X を実行する Python 実行ファイルが、 スクリプトを動かす Python と 同一かを確認 することから始める。

実行例

python:3.12(Debian GNU/Linux 13)環境で上記の手順を動かすと、import requests が ModuleNotFoundError で終了コード 1 になった。
python -m pip install で同一インタープリター(/usr/local/bin/python)へインストールすると、再実行は正常終了し、requests 2.31.0 がロードされた。

$ python -c "import sys; print(sys.version.splitlines()[0]); print('executable:', sys.executable)"
3.12.13 (main, Jul 14 2026, 04:46:18) [GCC 14.2.0]
executable: /usr/local/bin/python
$ python app.py
Traceback (most recent call last):
  File "/tmp/tmp.M9CRszfMS3/app.py", line 1, in <module>
    import requests
ModuleNotFoundError: No module named 'requests'
$ echo $?
1
$ python -m pip install --quiet requests==2.31.0
WARNING: Running pip as the 'root' user can result in broken permissions and conflicting behaviour with the system package manager, possibly rendering your system unusable. It is recommended to use a virtual environment instead: https://pip.pypa.io/warnings/venv. Use the --root-user-action option if you know what you are doing and want to suppress this warning.
 
[notice] A new release of pip is available: 25.0.1 -> 26.2
[notice] To update, run: pip install --upgrade pip
$ echo $?
0
$ python app.py
requests version: 2.31.0
$ echo $?
0
$ python -c "import requests, os; print('installed at:', os.path.dirname(requests.__file__))"
installed at: /usr/local/lib/python3.12/site-packages/requests

— 2026-08-02 時点の出力

検証環境2026-08-02 検証
検証日
実行環境
python:3.12

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. 実行 Python と pip の整合確認

which python
which pip
python -c "import sys; print(sys.executable)"

3つが同じ場所を指していなければ、まず venv を activate するか python -m pip install <pkg> で確実に紐付ける。

2. venv を作って隔離

python -m venv .venv
source .venv/bin/activate    # Windows: .venv\Scripts\activate
pip install <pkg>

3. 相対 import の解決

# パッケージ内のファイルを直接実行せず、モジュールとして起動
python -m mypackage.script

4. import 名を調べる

pip install 名と import 名は別物のことがある。
PyPI のページ/README で 正式な import 名 を確認する。

よくある原因

✕ pip と python が別の Python

pip install requestspython app.pyPython A/usr/bin/python3site-packagesrequests ✓Python B.venv/bin/pythonsite-packages(空)ここに入った✕ ModuleNotFoundError

✓ python -m pip で揃える

python -m pip install requestsPython B.venv/bin/pythonsite-packagesrequests ✓python app.py✓ 動く
pip が入れた先(Python A)と、python app.py を動かす Python(B)が別だと、入れたはずのパッケージが見つからない。python -m pip で入れると、実行する Python 自身の site-packages に入る。
  1. venv を活性化しておらず、system Python に入っている。
  2. pip install が別の Python(pyenv/conda/system)に対して走った。
  3. パッケージ名と import 名が異なる(例: opencv-python → cv2)。
  4. 相対 import を含むファイルを python script.py で直接実行している。