Pythonクラスを複数ファイルに分割する方法【初心者向けに実例付きで解説】

Pythonクラスを複数ファイルに分割するには？

Pythonプログラムやクラスを複数のファイルに分割したい場合、元のコードを役割ごとに整理し直し、2つ以上のクラスやモジュールへリファクタリング（書き換え）を行う必要があります。このとき最も重要なのは、分割後も元のコードが持っていた機能を損なわないことです。

ここでは、具体的な手順とコード例をもとに、分割の基本をわかりやすく解説します。

基本の考え方：クラスを「モジュール」として切り出す

Pythonでは1つの .py ファイルがひとつの「モジュール」として扱われます。そのため、クラスを別ファイルに切り出し、import文で読み込むのが最も一般的な手法です。

例えば、次のようにクラスだけを専用ファイルに分離できます。

# my_class.py（クラスを切り出したファイル）
class MyClass:
    def greet(self):
        return "こんにちは！"

# main.py（メインとなるファイル）
from my_class import MyClass

obj = MyClass()
print(obj.greet())  # 出力：こんにちは！

大きなクラスを分割する手順

1つのクラスが肥大化してしまった場合は、以下の流れで分割するとスムーズです。

1. 責務を洗い出す： クラス内のメソッドを、「データ処理」「画面表示」「ファイル入出力」など、担当する役割ごとにグループ化します。
2. 新しいクラスとして切り出す： 関連性の高いメソッド群を、独立した新しいクラスに移動させます。
3. 別ファイルへ保存： 新しいクラスをそれぞれ個別の .py ファイルとして保存します。
4. import文で連携させる： 元のファイルから新しく作ったモジュールをimportし、必要に応じてクラス間でやり取りできるようにします。

分割時の注意点

• 循環インポートに気をつける： お互いのファイルをimportし合う構造はエラーの原因になるため、依存関係は一方向になるよう設計しましょう。
• テストで動作を確認する： 分割前後で出力結果が変わらないか、既存のテストコードや簡単な実行で必ず検証してください。
• パッケージ化も検討する： ファイル数が増える場合は、ディレクトリに __init__.py を置いてパッケージとしてまとめると、管理しやすくなります。

まとめ

Pythonクラスの分割は「モジュール化 + import」が基本ですが、最適な切り分け方はプロジェクトの規模や目的によって変わります。まずは小さく試しながら、可読性と保守性の高いコードを目指してリファクタリングを行うことが大切です。