Python｜locals()関数の使い方

1. はじめに

Pythonには現在のスコープ（変数の有効範囲）で使われているローカル変数を取得できる便利な関数があります。それが locals() 関数です。

この記事では、Python｜locals()関数の使い方について、初心者の方でも理解できるように基礎から丁寧に解説していきます。具体的なコード例や実行結果を交えて、Pythonのスコープの理解を深めたい方にも役立つ内容となっています。

locals()を使えば、関数内で定義されている変数を辞書形式で一覧表示したり、動的なデバッグにも応用できます。初学者だけでなく中級者にもおすすめのテクニックです。

locals() 関数は、現在のローカルスコープ内で定義されている変数とその値を辞書型で返してくれる組み込み関数です。

基本的な構文は以下の通りです。

# ローカルスコープ内の変数を確認
def sample_function():
    x = 10
    y = "Hello"
    print(locals())

sample_function()

実行結果：

{'x': 10, 'y': 'Hello'}

このように、関数内で定義された変数 x と y が辞書形式で出力されているのが分かります。

– ローカルスコープ：関数やメソッドなどで定義された変数の範囲
– グローバルスコープ：モジュール全体で有効な変数の範囲

locals() は通常、関数の内部で使います。グローバルスコープでは、ほとんど globals() と同じ結果になります。

def debug_example():
    user = "Alice"
    age = 30
    active = True
    print("デバッグ中の変数一覧:", locals())

debug_example()

実行結果：

デバッグ中の変数一覧: {'user': 'Alice', 'age': 30, 'active': True}

エラー発生時や関数の挙動を確認したいときに、変数の状態を一気に確認できる便利な方法です。

def access_variable_dynamically():
    a = 5
    b = 15
    var_name = 'a'
    print("値:", locals()[var_name])

access_variable_dynamically()

実行結果：

値: 5

変数名を文字列として指定し、辞書のキーのように扱うことで、変数を動的に操作することができます。

def dynamic_variables():
    for i in range(3):
        locals()[f'var{i}'] = i  # 期待通りには動かない
    print(locals())

dynamic_variables()

実行結果：

{'i': 2}

locals() で辞書に要素を追加しても、実際のローカル変数としては認識されません。したがって、この使い方は非推奨です。

locals() は辞書のように見えても、ローカル変数として代入操作はできません。

def test_assignment():
    locals()['new_var'] = 100  # 効果なし
    print("new_var" in locals())  # False

test_assignment()

実行結果：

False

このように、辞書に追加しても実際の変数にはなりません。代入したい場合は通常の代入文を使いましょう。

スクリプトの先頭レベル（グローバルスコープ）で locals() を使うと、globals() と同じような結果が得られます。ただし、グローバルスコープでも値の変更は反映されません。

x = 1
locals()['x'] = 2
print(x)  # 1のまま

実行結果：

期待と違う動作をする可能性があるため、globals() との使い分けにも注意しましょう。

この記事では、Pythonのlocals()関数の使い方について以下のポイントを学びました。

実務でも、関数内の状態確認やロジックの検証などに活用できる場面があります。Pythonのスコープを理解することは、より深いコード理解につながる重要なステップです。

学習のコツ：
デバッグ時に locals() をprintで出力してみる習慣をつけることで、自分が定義した変数の状態を客観的に確認する練習になります。