【初心者向け】Pythonの if __name__ == "__main__" の意味と使い方を徹底解説

Pythonインタープリターがソースファイルを読み込むと、そのファイル内に書かれたすべてのコードが実行されます。

特殊変数 __name__ の正体

コードを実行する前に、Pythonはいくつかの特殊な変数を定義します。その一つが __name__ です。

• Pythonインタープリターがそのモジュール（ソースファイル）をメインプログラムとして直接実行している場合、__name__ には "__main__" という値が設定されます。
• 逆に、そのファイルが別のモジュールからインポートされた場合には、__name__ にはモジュール名が設定されます。

なぜこのチェックが必要なのか？

この仕組みが役立つ理由は、開発者が書くモジュール（.pyファイル）には、次の2つの使い方が考えられるからです。

1. 直接実行してプログラムとして動かす
2. 別のモジュールにインポートして、関数やクラスを再利用する

if __name__ == "__main__": のチェックを入れておけば、「モジュールをプログラムとして実行するときだけ」特定のコード（テスト処理やデモなど）を実行でき、単に関数を使いたいだけの人がモジュールをインポートしたときには余計な処理が走らないようにできます。

具体例：one.py と two.py で動作を確認しよう

ここでは2つのファイル one.py と two.py を用意して、実際の動作を見てみましょう。

one.py

def func():
    print("func() in one.py")

print("Root of one.py")

if __name__ == "__main__":
    print("one.py is being run directly")
else:
    print("one.py is being imported")

two.py

import one

print("Root of two.py")

one.func()

if __name__ == "__main__":
    print("two.py is being run directly")
else:
    print("two.py is being imported")

one.py を直接実行した場合

$ python one.py

出力結果：

Root of one.py
one.py is being run directly

one.py はメインプログラムとして実行されているため、__name__ が "__main__" になり、if文の中の処理が実行されています。

two.py を実行した場合（one.py をインポート）

$ python two.py

出力結果：

Root of one.py
one.py is being imported
Root of two.py
func() in one.py
two.py is being run directly

このとき、one.py はインポートされたため、__name__ の値は "one"（モジュール名）になります。その結果、「one.py is being run directly」ではなく「one.py is being imported」が出力され、if文の中のコードはスキップされます。

まとめ

• __name__ は、ファイルが直接実行されたかインポートされたかを判別できる特殊変数。
• if __name__ == "__main__": を使えば、スクリプトとして実行したときのみ動かしたい処理（テスト・デモ・CLI処理など）を分離できる。
• モジュールを再利用しやすくするための、Pythonにおける重要な定番イディオム。