Google Colabで自作モジュールをインポートする全手順｜.py変換からアップロードまで徹底解説【東大IPP・Python入門準拠】 🚀

🐍 Pythonモジュールの作り方・使い方完全ガイド：脱・スパゲッティコード！Python自作モジュール化でプログラムを劇的に整理する設計術 🧱

Pythonのプログラムが大きくなってくると、一つのファイルですべてを管理するのは大変です。そんな時に役立つのが「モジュール化」！コードを分割して整理整頓し、効率的な開発を目指しましょう。✨

📖本記事でマスターする重要キーワード

本セクションを読み進める前に、登場する中心的な概念を確認しておきましょう。これらを理解することで、プログラムの構造化がぐっとスムーズになります。

● モジュール (.py) Pythonのコードだけが書かれたファイル。他のプログラムから呼び出して使う「部品」です。

● ノートブック (.ipynb) Colab等で使用する、実行結果や解説が含まれたファイル。モジュールとは形式が異なります。

● インポート (import) 外部のモジュールを自分のプログラムに取り込んで、機能を使えるようにする操作のこと。

● UTF-8 モジュールを保存する際の標準的な文字コード。文字化けを防ぐために必須のルールです。

● 名前衝突 異なる場所で定義された同じ名前の変数が混ざり、エラーや予期せぬ挙動を起こす現象。

1. モジュールとは？（プログラムの部品化）🧱

モジュールとは、Pythonの関数やクラスをまとめた「部品」のようなものです。一度作った便利な機能を別のプログラムでも使い回せるようになります。

• 再利用性アップ： 同じコードを何度も書く必要がなくなります。
• 保守性アップ： プログラムが分割されるので、バグの修正や機能追加が簡単になります。

2. モジュールファイル (.py) の作成ルール 📄

普段使っているノートブック（.ipynb）と、モジュールとして使うファイル（.py）の違いを理解しましょう。

特徴	ノートブック (.ipynb)	モジュールファイル (.py)
構成要素	コード + テキスト + 実行結果	Pythonコードのみ
文字コード	-	UTF-8 (公式推奨)
主な役割	実験・試行錯誤・レポート	関数の定義・部品提供

3. ノートブックからモジュールへの変換手順 🔄

Google Colab等で作ったプログラムをモジュール化する手順は以下の通りです。

Step 1：.py形式でダウンロード

「ファイル」メニュー ＞ 「ダウンロード」 ＞ 「.py をダウンロード」 を選択します。
※これにより、テキスト部分はコメントアウトされ、コード部分だけが有効なファイルになります。

Step 2：Colabへのアップロード

ダウンロードしたファイルを別のプログラムで使うには、以下のコードを実行してアップロードします。📤

import sys if 'google.colab' in sys.modules: from google.colab import files uploaded = files.upload()  # ここで .py ファイルを選択

4. 自作モジュールの具体的な使い方 🚀

例えば、階乗を計算する factorial.py というファイルを作ったとします。

# factorial.py の中身 def fact(n): prod = 1 for i in range(1, n + 1): prod *= i return prod

💡 使用シーン別の呼び出し方（import）

① 基本の呼び出し（推奨）

モジュール名.関数名 で呼び出します。名前が衝突しにくい最も安全な方法です。

import factorial print(factorial.fact(6))  # 720

② 関数を直接指定して呼び出し

特定の関数だけを頻繁に使う場合に便利です。

from factorial import fact print(fact(6))  # 720

③ 別名を付けて呼び出し（as）

モジュール名が長すぎる時に短縮できます。

import factorial as f print(f.fact(6))  # 720

⚠️ 要注意：ワイルドカード（*）は使わない！
from factorial import * は、モジュール内のすべての機能を読み込みますが、読み込み元の変数名を意図せず上書きする（衝突する）リスクがあるため、推奨されていません。

5. 具体的な使用状況の例 🛠️

モジュール化は以下のような場面で特に役立ちます。

• データ分析の共通処理： データのクレンジング（掃除）用の自作関数をまとめ、複数のプロジェクトで共有する。
• 定数の管理： 設定値やAPIキー、数理定数などを一つのファイルにまとめて一括管理する。
• 大規模開発： チーム開発で「UI担当」「計算ロジック担当」「データベース担当」のようにファイルを分ける。

📌 まとめ：これだけは覚えよう！

• モジュールはプログラムを分割した .py ファイルのこと！
• ノートブックから .py をダウンロード して作成できる！
• 文字コードは必ず UTF-8 で保存しよう！
• 呼び出しは import モジュール名 が基本！
• 名前の衝突を避けるため、ワイルドカード（*）は控えよう！

【参考】
・Pythonプログラミング入門：5-2. モジュールの作り方
・Python公式ドキュメント：モジュール

💡 さらに理解を深めるための周辺知識

モジュールの作り方をマスターした皆さまへ。現場で役立つ背景知識や、次に学ぶべきステップを少しだけご紹介します。

• ▶ パッケージ化への道：
  モジュールが増えてきたら、それらを一つのフォルダにまとめて「パッケージ」にしましょう。__init__.py というファイル（現在は空でも可）をフォルダ内に置くことで、Pythonはそのフォルダをパッケージとして認識します。
• ▶ 「標準ライブラリ」との関係：
  Pythonには最初から math や os などの便利なモジュールが付属しています。これらは「標準ライブラリ」と呼ばれます。自作モジュールを作る前に、標準ライブラリに同様の機能がないか探すのも効率的な開発のコツです。
• ▶ モジュールの検索パス：
  import 文が実行されると、Pythonは特定の場所（カレントディレクトリや標準ライブラリのパスなど）を順番に探します。もし自作モジュールが読み込めない場合は、ファイルが適切な場所に置かれているか（sys.path で確認可能）を確認しましょう。

---

プログラムを「整理」することは、未来の自分へのプレゼントです。
モジュール化を使いこなし、読みやすく拡張性の高いコードを目指しましょう！

🤔 よくあるQ&A：こんな時どうする？

トラブルを素早く解決して、開発をスムーズに進めましょう。

Q1. ファイルをアップロードしたのに「ModuleNotFoundError」が出ます。

A. ファイル名のスペルと、配置場所を再確認してください。
Colabの場合、左側の「フォルダアイコン」をクリックして、.pyファイルが一番上の階層（sample_dataフォルダと同じ場所）にあるか確認しましょう。また、インポート時は拡張子の .py を含めてはいけません（✕ import test.py → 〇 import test）。

Q2. モジュールの中身を書き換えたのに、実行結果が変わりません。

A. Pythonは一度読み込んだモジュールをキャッシュするため、再インポートが必要です。
ノートブックの「ランタイムを再起動」するか、importlib.reload(モジュール名) を使って強制的に再読み込みを行ってください。単に import をもう一度書くだけでは反映されません。

Q3. 日本語のコメントを書くとエラー（文字化け）が発生します。

A. ファイルの保存形式が UTF-8 になっているか確認してください。
Windowsのメモ帳などで作成すると「Shift-JIS」という形式になりやすく、Pythonが正しく読み取れません。VS CodeやColabから直接作成・ダウンロードしたファイルであれば、原則としてUTF-8になるので安心です。

Q4. from import * を使わないほうがいい具体的な理由は？

A. 「どこから来た機能か」が分からなくなるからです。
例えば、自作モジュールと標準ライブラリの両方で sum という関数があった場合、* でインポートすると一方が上書きされてしまいます。コードの可読性と安全性のために、import モジュール名 または from ... import 関数名 を使いましょう。

⚠️ ひっかけ注意！一問一答チェックテスト

正解だと思う方をクリックして考えてみてください。（※直感で選ぶと間違えるかも！？）

Q1. factorial.py という自作ファイルをインポートする正しい書き方は？

A. import factorial.py B. import factorial

※正解は B（拡張子は不要です）

Q2. モジュールファイルを書き換えて保存しました。もう一度 import を実行すれば変更は反映される？

A. はい、反映される B. いいえ、反映されない

※正解は B（importlib.reload() が必要）

Q3. from my_module import * を使うと記述が楽になります。この書き方の評価は？

A. 効率的なので推奨される B. 名前衝突のリスクがあるため非推奨

※正解は B

Q4. Jupyter Notebook (.ipynb) のファイルをそのまま import することはできる？

A. できる B. できない

※正解は B（.pyに変換が必要）

1. 実践：factorial.pyを作成してColabで動かそう

まずは、Colab上で直接モジュールファイルを作成し、それをインポートする流れを体験しましょう。

ステップ①：ファイル作成コードを実行

with open('factorial.py', 'w') as f: f.write(''' def fact(n): """階乗を計算する関数""" prod = 1 for i in range(1, n + 1): prod *= i return prod ''')

ステップ②：インポートして実行

import factorial print(factorial.fact(5))  # 出力: 120

2. モジュール修正後の「再読み込み」テクニック

Pythonは一度インポートしたモジュールをメモリに保持するため、.pyファイルを書き換えても通常のimportでは変更が反映されません。 その場合は importlib を使います。

import importlib import factorial # ファイルを書き換えた後に実行すると、最新の状態に更新されます importlib.reload(factorial)

3. 演習：複数の関数を持つ「便利計算ツール」を作ろう

実務では1つのモジュールに複数の関数をまとめます。以下の my_utils.py を作成してみましょう。

# my_utils.py の中身を想定 def greet(name): return f"こんにちは、{name}さん！" def add_tax(price): return int(price * 1.1)  # 10%税込価格

呼び出し側のコード：

from my_utils import greet, add_tax print(greet("Python学習者")) print(f"合計金額: {add_tax(1000)}円")

4. 応用：複数のモジュールを「パッケージ」にまとめる

関連するモジュールが増えたら、フォルダにまとめて管理（パッケージ化）します。

構成例：

• 📂 my_tools/ (フォルダ)
• 　┣ 📄 __init__.py (中身は空でOK。パッケージの目印)
• 　┣ 📄 math_tool.py
• 　┗ 📄 str_tool.py

呼び出し方： from my_tools import math_tool

5. トラブル解決！よくあるエラーと解決策（デバッグ）

❌ ModuleNotFoundError: No module named '...

原因： モジュールファイルが現在のディレクトリに見つかりません。
解決策： Colabの左側メニュー（フォルダアイコン）を開き、.pyファイルが正しく存在するか確認してください。

❌ AttributeError: module '...' has no attribute '...

原因： 関数名が間違っているか、ファイルの保存（更新）が反映されていません。
解決策： importlib.reload() を試すか、ファイル内の関数名のスペルをチェックしてください。

❌ ImportError: cannot import name '...' from '...

原因： from ... import ... で指定した名前がモジュール内に存在しません。
解決策： モジュール側の def 関数名: が正しく定義されているか確認しましょう。

参考：5-2. モジュールの作り方 — Pythonプログラミング入門