Pythonでモジュールを動的にインポートする方法：importlibの使い方を解説

importlibを使った動的インポートの基本

Pythonでは、標準ライブラリのimportlibパッケージに含まれるimport_module()関数を使うことで、プログラムの実行中にモジュールを動的にインポートできます。引数には、インポートしたいモジュール名を文字列として指定します。

>>> from importlib import import_module
>>> moduleName = "os"
>>> globals()[moduleName] = import_module(moduleName)

このコードでは、"os"という文字列をモジュール名として渡し、インポートされたモジュールオブジェクトをglobals()辞書に登録しています。これにより、通常のimport osと同様に、以降のコードでosモジュールをそのまま利用できるようになります。

複数のモジュールを一括で動的にインポートする

モジュール名のリストを用意すれば、forループと組み合わせて、複数のモジュールをまとめて動的にインポートすることも可能です。

>>> import importlib
>>> modnames = ["os", "sys", "math"]
>>> for lib in modnames:
...     globals()[lib] = importlib.import_module(lib)

globals()は、現在のグローバルスコープのシンボルテーブル（辞書）を返します。この辞書に対して、各モジュール名をキーとして、インポート結果のモジュールオブジェクトを順に代入していく仕組みです。

パッケージ内のサブモジュールを動的にインポートする

すでにインポート済みのパッケージに属するモジュールを読み込みたい場合も、同じ関数で対応できます。その際は、モジュール名単体ではなく、「パッケージ名.モジュール名」というドット区切りの完全な名前を指定する必要があります。

>>> import importlib
>>> pack = 'datetime'
>>> mod = 'date'
>>> globals()[pack] = importlib.import_module(pack)
>>> globals()[pack + '.' + mod] = importlib.import_module(pack + '.' + mod)

この例では、まずdatetimeパッケージ自体をインポートし、続いてそのサブモジュールであるdatetime.dateを完全修飾名でインポートしています。

動的インポートを活用する際の注意点

動的インポートは非常に柔軟な手法ですが、コードの可読性が下がったり、静的解析ツールやIDEによる補完・型チェックが効かなくなったりすることがあります。そのため、特別な理由がない限りは通常のimport文を使うことが推奨されます。

一方で、プラグインシステムの構築や、設定ファイルの内容に応じてモジュールを読み替える処理など、実行時になるまでモジュール名が確定しないケースでは、importlibが大きな力を発揮します。用途に応じて適切に使い分けましょう。