・0 pv・4 min read
【Python】import でエラーが出る原因と解決法まとめ
Pythonを書いていると、たまにながらも、少なからず困らされるimportでのエラー
ModuleNotFoundError: No module named '〇〇'pip install したのにでたりして、良く困ったので、
よくある原因をまとめてみました。
よくある原因をまとめてみました。
原因1：単純にインストールされていない
pip install した先が他の仮想環境だったり、仮想環境を変更しながら、installを忘れていた場合によく起こります。
起動した Python がいつもと違ってたりしないかどうかの確認をしましょう。
原因2：pip install 名と import 名が違う（初心者最大の罠）
Python の世界には、インストール名（PyPI の名前）と import 名（実際に import する名前）が一致しないパッケージがたくさんあります。これ、知らないと本当にハマります。
| pip install の名前 | import の名前 |
|---|---|
| beautifulsoup4 | bs4 |
| pillow | PIL |
| opencv-python | cv2 |
| pycryptodome | Crypto |
| python-dateutil | dateutil |
| PyYAML | yaml |
| pywin32 | win32api |
pip install beautifulsoup4 してから import bs4 が正解調べればでてくるけど、記憶を頼りにやってると、案外起きます。
原因3：ローカルに同名ファイル
事例
プロジェクト直下に
結果、本家の
プロジェクト直下に
yaml.py や requests.py といったファイルを置いてしまうと、Python はそちらを優先して読み込もうとします。結果、本家の
PyYAML や requests が読み込めずエラーになる――というパターン。症状の例
ModuleNotFoundErrorも出るが、ImportErrorや妙な属性エラーになる- パスを見たら、カレントディレクトリが先に来ている
チェック方法
対処
- ローカルファイル名を変更する（例：
my_yaml.py→yaml_helper.py等） __pycache__/を削除してから再実行
原因4：大文字小文字の違い
Python の import は大文字小文字を区別します。
import Numpy # NG
import numpy # OK絶対に小文字というわけでも、絶対に大文字というわけでもないので、調べるしかありません。
おまけ：慣習による as インポート
beautifulsoup4はimport bs4だが、numpyはnpではない。が、npの記述をよく見ると思います。
慣習として、使われているので覚えておくと楽です。 また、どの関数も自在に設定はできます。
慣習として、使われているので覚えておくと楽です。 また、どの関数も自在に設定はできます。
| import の書き方 | 備考 |
|---|---|
import numpy as np | 数値計算。np は世界標準。 |
import pandas as pd | データ解析。pd は慣習。 |
import matplotlib.pyplot as plt | グラフ描画。長いので短縮。 |
import tensorflow as tf | 機械学習ライブラリの慣習。 |
import seaborn as sns | 可視化ライブラリの慣習。 |
ポイント：エラーのときは、まずエイリアスを外して本来の名前で
import してみると混乱が減ります。実は本題 おまけ2：Python から自動でインストールさせる方法
仮想環境をコロコロ切り替えながらも、いちいち、pipでやるのがめんどくさい人の最終手段
実行時に不足モジュールを自動インストールする方法
例
try:
import numpy
except ModuleNotFoundError as e:
import subprocess
import sys
module_name = str(e).split()[-1].strip("'") # エラーメッセージからモジュール名取得
subprocess.check_call([sys.executable, "-m", "pip", "install", module_name])
import numpyちなみに、特におすすめはしていませんので、やる場合は自己責任で
再発防止ミニチェックリスト
python -m pip install ...で確実に実行中の Python に入れるpip freeze > requirements.txtを用意して共有する- プロジェクト直下にライブラリ名のファイルを置かない（
yaml.pyなど）