Pythonにおけるimportエラーの回避方法を現役エンジニアが解説【初心者向け】

初心者向けにPythonにおけるimportエラーの回避方法について現役エンジニアが解説しています。モジュールのインポートが出来なかった場合に発生するエラーです。モジュール名の確認やカレントディレクトリの確認、インストール済みかどうかを確認します。

TechAcademyマガジンはオンラインのプログラミングスクールTechAcademy [テックアカデミー]が運営する教育×テクノロジーのWebメディアです。初心者でもすぐ勉強できる記事が2,000以上あります。

Pythonにおけるimportエラーの回避方法について、TechAcademyのメンター(現役エンジニア)が実際のコードを使用して、初心者向けに解説します。

 

Pythonについてそもそもよく分からないという方は、Pythonとは何なのか解説した記事を読むとさらに理解が深まります。

 

なお本記事は、TechAcademyのオンラインブートキャンプ、Python講座の内容をもとに紹介しています。

 

田島悠介

今回は、Pythonに関する内容だね!

大石ゆかり

どういう内容でしょうか?

田島悠介

Pythonにおけるimportエラーの回避方法について詳しく説明していくね!

大石ゆかり

お願いします!

 

importエラーとは?

Pythonではimport文でモジュールをインポートできますが、インポート中に問題があるとImportError例外が発生します。

import foo

上記のコードではfooモジュールをインポートしますが、fooモジュールが存在しません。すると、以下のような例外が発生します。

ModuleNotFoundError                       Traceback (most recent call last)
----> 1 import foo
ModuleNotFoundError: No module named 'foo'

ModuleNotFoundErrorImportErrorのサブクラスです。
 

importエラーを回避するために確認すること

上述の通り、ImportError例外はインポート中に何らかの問題が発生したことを示しています。

ソースコード上のエラー発生箇所周辺で、以下のような点を確認します。

  • モジュール名称が正確か。スペルミスはないか。
  • 自作モジュールの場合にはカレントディレクトリにファイルがあるか。
  • 外部モジュールの場合にはpipコマンドでインストール済か。

 

[PR] Pythonで挫折しない学習方法を動画で公開中

importエラーを回避する正しい記述を理解する

Pythonはsys.pathリストに格納されたパス配下でモジュールを探索します。

モジュールを正しく配置しているつもりだがインポートできない場合には、sys.pathの値を調べ調査の手がかりとします。

import sys
print(sys.path)

 

監修してくれたメンター

橋本紘希(はしもとひろき)

システムインテグレータ企業勤務のシステムエンジニア。

開発実績: Javaプログラムを用いた業務用Webアプリケーションや、基幹システム用バッチアプリケーションなどの設計構築試験。

 

大石ゆかり

内容分かりやすくて良かったです!

田島悠介

ゆかりちゃんも分からないことがあったら質問してね!

大石ゆかり

分かりました。ありがとうございます!

 

TechAcademyでは、初心者でも最短4週間で、Pythonを使った人工知能(AI)や機械学習の基礎を習得できる、オンラインブートキャンプを開催しています。

また、現役エンジニアから学べる無料体験も実施しているので、ぜひ参加してみてください。