Pythonのreload()関数とは？モジュールを再読み込みする方法を解説

Pythonのreload()関数とは

Pythonのreload(moduleName)関数は、すでに読み込まれているモジュールを再読み込み（リロード）するための機能です。モジュールを読み込む際は、通常どおり import moduleName の構文でインポートしておく必要があります。

この関数は、対話型セッションでの利用を想定して設計されています。たとえば、モジュールのソースファイルを編集した後、Pythonインタプリタを終了して再起動することなく、変更内容をすぐにテストしたい場合に便利です。

reload()の基本的な使い方

以下は、モジュールを編集した後に再読み込みする基本的な例です。

>>> import mymodule
>>> # mymodule を編集したので、このセッション内で再読み込みする
>>> reload(mymodule)

注意点：引数は文字列ではなくモジュール名そのもの

reload()に渡す引数は、モジュール名を格納した文字列ではなく、実際のモジュールオブジェクトそのものである点に注意してください。誤って文字列を渡すとエラーになります。

Python 3でのreloadの扱い

Python 2ではreload()は組み込み関数として提供されていましたが、Python 3では組み込み関数から外され、impモジュールへ移動しました。そのため、Python 3でreloadを使う場合は、次のように記述します。

>>> import imp
>>> imp.reload(mymodule)

なお、Python 3.4以降ではimpモジュール自体が非推奨となり、代わりに標準ライブラリのimportlibモジュールを使うことが推奨されています。最新のコードでは以下のように書くのが一般的です。

>>> import importlib
>>> importlib.reload(mymodule)

まとめ

reload()関数は、開発中にモジュールの変更を即座に反映させたい場合に役立つ機能です。Python 2では組み込み関数として直接使えますが、Python 3ではimp.reload()、さらに新しい環境ではimportlib.reload()を使用する点を覚えておきましょう。