Pythonモジュールをアンロード（リロード）するにはどうすればよいですか？

Pythonモジュールのリロード方法

Pythonで一度インポートしたモジュールを再読み込み（リロード）するには、reload()関数を使用します。この関数は、スクリプトを終了せずにimport文で読み込んだ済みのモジュールを再度ロードします。

主な用途は対話的な開発シーンです。モジュールのソースファイルを編集した後、Pythonインタプリタを終了して起動し直すことなく、変更内容をすぐにテストできます。

基本的な使い方

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

注意点

引数に指定するのは、モジュール名を格納した文字列ではなく、モジュールオブジェクトそのものである点に注意してください。

reload関数の動作仕様

Python公式ドキュメントでは、reload()関数の動作について以下のように説明されています。

• モジュールのPythonコードが再コンパイルされ、モジュールレベルのコードが再実行され、モジュールの辞書内の名前にバインドされる新しいオブジェクト群が定義される。
• 拡張モジュール（C言語などで実装されたモジュール）の初期化関数は、2回目は呼び出されない。
• モジュールの名前空間内の名前は、新規または変更されたオブジェクトを指すように更新される。
• ただし、古いオブジェクトへの他の参照（モジュール外部から取得した名前など）は自動的には更新されないため、必要に応じて各名前空間で手動的に更新する必要がある。

Python 3での注意

Python 2では組み込み関数としてreload()が提供されていましたが、Python 3ではimportlibモジュールに移動されています。Python 3環境では以下のように記述します。

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

この違いを理解しておくと、バージョン間の移行時に混乱を避けられます。