Pythonのglobals()・locals()・reload()関数の使い方を徹底解説

Pythonには、名前空間（ネームスペース）の中身を確認できる便利な組み込み関数として globals() と locals() が用意されています。この記事では、これら2つの関数の違いと使い方、さらにモジュールを再読み込みする reload() 関数についてわかりやすく解説します。

globals()とlocals()とは

globals() と locals() は、呼び出された位置に応じて、それぞれグローバル名前空間とローカル名前空間に存在する名前（変数名や関数名など）を返す関数です。

関数内で呼び出した場合の挙動

locals() を関数内で呼び出した場合、その関数の内部からローカルにアクセスできるすべての名前が返されます。つまり、その関数内で定義された変数や引数などが含まれます。

globals() を関数内で呼び出した場合、その関数からグローバルにアクセスできるすべての名前が返されます。モジュールレベルで定義された変数や組み込み関数などが該当します。

戻り値は辞書型

両方の関数の戻り値は辞書（dict）型です。そのため、keys() メソッドを使えば、名前空間に登録されている名前の一覧を簡単に取り出せます。

def sample_func():
    x = 10
    print(locals().keys())   # ローカル名前空間の名前一覧
    print(globals().keys())  # グローバル名前空間の名前一覧

sample_func()

reload()関数でモジュールを再読み込みする

モジュールをスクリプトにインポートすると、モジュールのトップレベルにあるコードは最初のインポート時に一度だけ実行されます。以降、同じモジュールを何度インポートしても、トップレベルのコードは再実行されません。

そこで、モジュールのトップレベルコードを再実行したい場合に活躍するのが reload() 関数です。reload() を使うと、すでにインポート済みのモジュールを再度読み込むことができます。

reload()の構文

reload(module_name)

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

たとえば、hello モジュールを再読み込みする場合は次のように記述します。

import hello
reload(hello)

補足：Python 3でのreload()の扱い

reload() はPython 2では組み込み関数として提供されていましたが、Python 3では組み込み関数から削除され、imp モジュール（Python 3.4以降は非推奨）や標準ライブラリの importlib に移動しています。Python 3環境でモジュールを再読み込みする場合は、次のように記述します。

import importlib
import hello

importlib.reload(hello)

このように、実行しているPythonのバージョンに応じて適切な方法を選択することが重要です。