1つのPythonファイルには何個のクラスを書くべき？モジュール設計の基本

Pythonのコードは「モジュール」と「パッケージ」で整理される

Pythonでは、コードは「モジュール」と呼ばれるファイルにまとめられ、さらに互いに関連するモジュール群は「パッケージ」としてグループ化されます。

モジュールは「再利用の単位」

モジュールとは、密接に関連する1つ以上のクラスを含む独立したコードの単位です。モジュールの中身を読んだり、実際に使ったり、保守・拡張を行う際には、必ず事前にインポートが必要になります。このことから、モジュールはコードの再利用の単位だと言えます。

基本原則はシンプルです。「モジュール＝再利用の単位」。Python標準ライブラリをはじめとする各種ライブラリや、他の開発者が作ったPythonアプリケーションも、すべてモジュール単体か、あるいは複数のモジュールからなるパッケージで構成されています。

1ファイルあたりのクラス数に厳密な上限はない

結論から言うと、1つのファイル（モジュール）に含められるクラスの数に、言語仕様上の制限は一切ありません。適切なクラス数は、以下の要素によって変わってきます。

• プロジェクトの規模：小規模なスクリプトなら1ファイルに複数クラスをまとめても問題ありませんが、大規模なプロジェクトでは分割が推奨されます。
• クラスの長さ：短いクラスであれば同じファイルにまとめても読みやすい一方、長大なクラスが並ぶと可読性が低下します。
• クラス間の関連性：役割が似ているクラス同士は同じモジュールに、責務が異なる場合は別ファイルに分けるのが自然です。

実践的な判断基準

重要なのは「利便性」と「効率的で生産的なコード整理」です。多くのスタイルガイドでは、1つのモジュールが肥大化しすぎないよう注意を促しており、目安として数百行程度に収め、それ以上大きくなるようであれば機能ごとにファイルを分割するのが良いとされています。

迷ったときは「このモジュールを他のプロジェクトでもそのまま再利用できるか？」という問いを立ててみましょう。再利用を意識したモジュール分割は、結果的に保守しやすく拡張しやすいコードベースにつながります。