Pythonで書かれた多くのスクリプトを見ると、ファイルの最後に
if __name__ == '__main__':
という見慣れないコードブロックがあることに気づくでしょう。これは、Pythonスクリプトがどのように実行されるかを制御するための、非常に重要で便利な構文です。
__name__とは？
まず、__name__とは、Pythonがすべてのモジュール（.pyファイル）に自動で割り当てる特別な変数です。この変数の値は、そのスクリプトがどのように実行されたかによって変わります。
-
直接実行された場合
-
他のモジュールからインポートされた場合
-
スクリプトが
import文を使って別のファイルから読み込まれたとき、__name__変数の値はそのモジュール自身の名前になります（例：'my_script'）。
-
if __name__ == '__main__':の役割
この条件文は、「もしこのスクリプトが直接実行されたら、以下のコードブロックを実行する」という意味になります。
これにより、直接実行されたときだけ特定のコードを実行し、他のファイルからインポートされたときはそのコードを実行しないように制御できます。
具体的な使用例
example.pyというファイルで、以下のようなコードを考えてみましょう。
# ファイル名: example.py
def say_hello():
print("こんにちは！")
def main():
print("プログラムが開始されました。")
say_hello()
if __name__ == '__main__':
main()
このコードを以下のように実行すると、main()関数が実行されます。
$ python example.py
プログラムが開始されました。
こんにちは！
なぜこの構文が必要なのか？
この構文の最大の利点は、コードの再利用性を高めることです。
example.pyを別のファイルanother_script.pyからインポートしたいとします。
# ファイル名: another_script.py
from example import say_hello
print("another_scriptが実行されました。")
say_hello()
if __name__ == '__main__':がなければ、another_script.pyをインポートしただけでexample.pyのmain()関数が自動的に実行されてしまいます。これは望ましくありません。
しかし、この構文があることで、インポートされたときはif文の条件がFalseとなり、main()関数は実行されず、say_hello()関数だけが利用可能になります。
$ python another_script.py
another_scriptが実行されました。
こんにちは！
まとめ
-
__name__は、スクリプトの実行方法によって値が変わる特別な変数です。 -
if __name__ == '__main__':は、直接実行されたときだけ特定のコードを実行するガード（門番）の役割を果たします。 -
この構文を使うことで、モジュールとして再利用可能なコードと、直接実行時に動くコードを明確に分けることができます。
Pythonで再利用可能なスクリプトを書く際は、このif __name__ == '__main__':を積極的に活用しましょう。これはプロのPython開発者にとっての必須の習慣です。
