PythonでImportError例外をキャッチする方法をわかりやすく解説

Pythonでは、モジュールやそのメンバー(関数・クラスなど)がインポートできない場合に、ImportError 例外が発生します。この記事では、ImportErrorが発生する主な2つのケースと、try-except文を使った適切なエラーハンドリングの方法を解説します。

ImportErrorが発生する2つのケース

• 存在しないモジュールをインポートしようとした場合
• from X import Y の形式で、モジュールXの中にYという名前のメンバーが見つからない場合

ケース1: 存在しないモジュールのインポート

以下の例では、存在しない「exception」というモジュールから myexception をインポートしようとしています。インポートに失敗すると、exceptブロックでエラーメッセージと例外の型が出力されます。

import sys
try:
    from exception import myexception
except Exception as e:
    print(e)
    print(type(e))

出力結果

No module named 'exception'
<class 'ImportError'>

モジュール自体が見つからないため、「No module named」というメッセージとともに ImportError が送出されていることがわかります。

ケース2: モジュール内に存在しない名前のインポート

次の例では、標準ライブラリの time モジュールから datetime をインポートしようとしています。しかし、datetime は time モジュールには含まれていないため、ImportError が発生します。

import sys
try:
    from time import datetime
except Exception as e:
    print(e)
    print(type(e))

出力結果

cannot import name 'datetime' from 'time'
<class 'ImportError'>

このように、モジュールは存在するものの、指定した名前のメンバーがその中に定義されていない場合にも ImportError が送出されます。

ポイントまとめ

• ImportError を個別にキャッチしたい場合は、except ImportError as e: のように記述するとより明確になります。
• Python 3では、例外オブジェクトの型は type(e) で取得できます。
• オプションの依存関係を扱う場合など、モジュールが存在するかどうかを実行時に確認したい場面で try-except によるインポートは特に有効です。

import文をtry-exceptブロックで囲むことで、モジュールや名前が見つからない場合でもプログラムがクラッシュせず、適切にエラーを処理できるようになります。