Pythonの__init__.pyとは？役割と基本的な使い方をわかりやすく解説

__init__.pyファイルの役割とは

Pythonにおいて、__init__.pyファイルは、ディレクトリを「パッケージ」として認識させるために必要なファイルです。このファイルが存在することで、Pythonはそのディレクトリをひとつのパッケージとして扱うことができるようになります。

この仕組みには重要な目的があります。それは、stringのような一般的な名前を持つディレクトリが、モジュール検索パス上の後続にある正規のモジュールを意図せず隠してしまう（シャドーイングする）ことを防ぐためです。

__init__.pyの中身は空でもOK

最もシンプルなケースでは、__init__.pyは単なる空のファイルでも問題ありません。しかし、それだけにとどまらず、次のような用途にも活用できます。

• パッケージがインポートされるときに実行される初期化コードを記述する
• __all__変数を設定し、from package import *でインポートされるモジュールを制御する

__init__.pyの記述例

from math import sin
from my_package import my_func

上記のコードのように__init__.pyに関数やモジュールのインポート文を定義しておくと、そのパッケージがインポートされた時点で、これらの関数がパッケージ内の各モジュールから利用可能になります。これにより、利用者側は深い階層のモジュールパスを意識せずに、シンプルな形式でインポートできるようになります。

まとめ

__init__.pyは、単なる「パッケージの目印」ではなく、初期化処理や公開APIの整理など、パッケージ設計において重要な役割を担うファイルです。空のファイルとして最小限の構成から始め、必要に応じてコードを追加していくのが一般的な使い方です。