Pythonの名前空間（Namespace）とは？仕組みをわかりやすく解説

名前空間はスコープを実現する仕組み

Pythonにおける名前空間（Namespace）とは、変数名とオブジェクトを対応付ける「辞書」のようなもので、スコープ（有効範囲）を実現するための基本的な仕組みです。

Pythonでは、パッケージ・モジュール・クラス・関数・メソッドといったそれぞれの構成要素が、独自の名前空間を持っています。変数名の解決（どのオブジェクトを指すのかの判定）は、この名前空間の中で行われます。

名前空間はいつ作られ、いつ消える？

関数やモジュール、パッケージが評価され、実行が開始されるときに、そのための新しい名前空間が生成されます。これは「実行コンテキスト」と考えるとイメージしやすいでしょう。

そして、その関数などの実行が終了すると、対応する名前空間は破棄されます。それに伴い、その中で定義されていた変数も一緒に消えます。これが、ローカル変数が関数の外から参照できない理由です。

名前の検索順序：ローカル → グローバル

変数名を参照するとき、Pythonはまずローカルの名前空間（関数の本体やモジュールなど、現在のスコープ）を調べます。そこに該当する名前が見つからなければ、次にグローバルな名前空間を確認します。

さらに詳しく言えば、Pythonの名前解決は「LEGBルール」と呼ばれる順序で行われます。

• L（Local）：現在の関数内のローカル名前空間
• E（Enclosing）：外側にネストされた関数の名前空間
• G（Global）：モジュールレベルのグローバル名前空間
• B（Built-in）：print や len など、組み込み名前空間

この順番で上から探索し、最初に見つかった名前が使用されます。

変数はどこに作られる？

通常、変数は代入された時点でローカルの名前空間にのみ作成されます。しかし、global 文や nonlocal 文を使うことで、ローカル以外の名前空間（グローバル空間や外側の関数の空間）に変数を作成・更新することも可能です。

counter = 0  # グローバル名前空間に作成

def increment():
    global counter
    counter += 1  # global宣言によりグローバル変数を更新

increment()
print(counter)  # 1

まとめ

名前空間とは、変数名が属する「世界」のようなものです。Pythonでは各パッケージ・モジュール・クラス・関数がそれぞれ独立した名前空間を持ち、実行時に生成され、終了時に破棄されます。名前の参照はローカルから始まり、見つからなければグローバルへと順に探索される——この基本動作を理解しておくと、スコープ関連のバグやエラーの原因を素早く特定できるようになります。