Pythonのモジュール分割:コードを複数ファイルに分ける

入門 | 12分 で読める | 2026.07.12

公式ドキュメント

今回やること

コードが長くなると、1つのファイルだけでは読みにくくなります。

モジュール分割は、役割ごとにファイルを分けて読みやすくする方法です。

今回は、別ファイルに関数を書き、メインファイルから呼び出します。

ファイルを2つ作る

同じフォルダに、次の2ファイルを作ります。

main.py
utils.py

utils.py に関数を書きます。

def create_greeting(name):
    return f"{name}さん、こんにちは"

main.pyから読み込む

from utils import create_greeting

message = create_greeting("Ada")
print(message)

同じフォルダにある utils.py から関数を読み込めます。

ファイルの役割を分ける

ファイル役割
main.py実行の入口
utils.py共通関数
settings.py設定値

最初は、このくらいの分け方で十分です。

よくあるエラー

エラー原因修正
ModuleNotFoundErrorファイルの場所が違う同じフォルダに置く
ImportError関数名が違う定義名とimport名を確認
勝手に実行されるimport先に実行コードがある関数にまとめる

練習

  1. utils.py を作る
  2. 挨拶関数を定義する
  3. main.py からimportする
  4. 計算用の関数も追加する

次のステップ

日付を扱う標準ライブラリは Pythonのdatetime入門 で練習します。

参考リソース

← 一覧に戻る
PR
PR
PR
PR