Python ModuleNotFoundError の原因と解決法

importしようとしたモジュールが見つからないときに発生するエラーです。名前のタイポか、ライブラリの未インストールがほとんどの原因です。

このエラーメッセージ

ModuleNotFoundError: No module named 'maths'

原因

モジュール名をタイプミスしている（maths→math など）
外部ライブラリをpip installしていない
自作ファイル名が標準モジュール名と衝突している（random.py など）

❌ エラーになるコード

import maths  # 正しくは math

print(maths.sqrt(16))

✅ 修正したコード

import math

print(math.sqrt(16))
print(math.pi)

▶ 修正済みコードを実行エディタで開く

progoのPython実行環境（インストール不要・登録不要）でその場で動作を確認できます。

解決のポイント

まずモジュール名のつづりを確認します。標準ライブラリ（math・random・datetimeなど）はインストール不要でimportできます。外部ライブラリの場合はターミナルでpip install ライブラリ名を実行してからimportします。また、自分のファイルにrandom.pyのような標準モジュールと同じ名前を付けると衝突するので避けましょう。

よくある質問

pip installしたのにエラーが出るのはなぜ？

Pythonが複数入っていて、pipのインストール先と実行しているPythonが違うことが多いです。python -m pip install ライブラリ名とすると確実です。

ImportErrorとの違いは？

ModuleNotFoundErrorはモジュール自体が見つからない場合、ImportErrorはモジュールはあるが中の名前を読み込めない場合（from math import sqr など）に発生します。