Python

Pythonのimport文の使い方｜モジュール活用の基本

Pythonのimport文とモジュールの使い方を詳しく解説。基本的なimportから、from文、as文、標準ライブラリの活用方法まで、実践的なコード例とともに初心者向けに分かりやすく説明します。

Learning Next 運営
約 26 分で読めます
Pythonimportモジュールライブラリ標準ライブラリ

Pythonのimport文の使い方｜モジュール活用の基本

「import文って何？」「モジュールって難しそう...」と感じていませんか？

みなさん、Pythonを学習していてこんな疑問を持ったことはありませんか？

「import文って何のために使うの？」 「モジュールやライブラリの違いがわからない」 「エラーが出て思うように使えない」

実は、import文はPythonの強力な機能を活用するために必須の知識なんです。

この記事では、Pythonのimport文とモジュールの使い方を基本から詳しく解説します。 実践的なコード例とともに、効率的なプログラミングのためのモジュール活用方法をお伝えしますよ！

import文とモジュールって何だろう？

まず、import文とモジュールの基本的な概念を理解しましょう。

簡単に言うと、既に作られた便利な機能を自分のプログラムで使えるようにする仕組みです。

モジュールとは？

モジュールとは、Pythonコードが書かれたファイルのことです。

他のプログラムから再利用できる関数やクラス、変数をまとめたものです。

例えば、こんな感じで自分で作ることもできます。

# math_utils.py（自作モジュールの例）
def add(a, b):
    """2つの数値を足し算する関数"""
    return a + b


def multiply(a, b):
    """2つの数値を掛け算する関数"""
    return a * b


PI = 3.14159

このファイルを作ると、他のプログラムから使い回せるようになります。

import文の基本的な使い方

import文は、モジュールを読み込んで使えるようにする命令です。

基本的な使い方を見てみましょう。

# 基本的なimport文の使い方


# 1. モジュール全体をインポート
import math
import datetime


# 使用例
print(f"円周率: {math.pi}")
print(f"現在時刻: {datetime.datetime.now()}")

このコードを実行すると、mathモジュールとdatetimeモジュールが使えるようになります。

実行結果：

円周率: 3.141592653589793 現在時刻: 2024-07-07 10:30:00.123456

math.piのように、「モジュール名.機能名」の形で使います。

特定の機能だけを取り出す方法

# 2. 特定の関数や変数のみをインポート
from math import pi, sqrt
from datetime import datetime


# モジュール名なしで使用可能
print(f"π = {pi}")
print(f"√16 = {sqrt(16)}")
print(f"現在時刻: {datetime.now()}")

fromを使うと、モジュール名を付けずに直接機能を使えます。

短い名前を付ける方法

# 3. エイリアス（別名）を付けてインポート
import datetime as dt
import math as m


# 短い名前で使用可能
print(f"円周率: {m.pi}")
print(f"現在時刻: {dt.datetime.now()}")

長いモジュール名を短くして使いやすくできます。

標準ライブラリを活用してみよう

Pythonには豊富な標準ライブラリが最初から付いています。

よく使われるものを実際に使ってみましょう。

日付・時刻の操作

import datetime
from datetime import datetime, date, timedelta


def datetime_examples():
    """日付・時刻の操作例"""
    
    # 現在の日時
    now = datetime.now()
    print(f"現在日時: {now}")
    print(f"年: {now.year}, 月: {now.month}, 日: {now.day}")
    
    # 日付の計算
    tomorrow = now + timedelta(days=1)
    next_week = now + timedelta(weeks=1)
    
    print(f"明日: {tomorrow.strftime('%Y-%m-%d')}")
    print(f"来週: {next_week.strftime('%Y-%m-%d %H:%M')}")


datetime_examples()

このコードでは、現在の日時を取得して表示しています。

また、1日後や1週間後の日付も計算できます。 strftimeを使うと、日付の表示形式を自由に設定できます。

ファイル・ディレクトリ操作

import os
from pathlib import Path


def file_operations():
    """ファイル操作の例"""
    
    # 現在のディレクトリ情報
    current_dir = os.getcwd()
    print(f"現在のディレクトリ: {current_dir}")
    
    # ディレクトリ内のファイル一覧
    files = os.listdir(".")
    python_files = [f for f in files if f.endswith('.py')]
    print(f"Pythonファイル数: {len(python_files)}")
    
    # pathlibを使った現代的な方法
    current_path = Path(".")
    py_files = list(current_path.glob("*.py"))
    
    print("Pythonファイル一覧:")
    for py_file in py_files[:3]:  # 最初の3ファイル
        file_size = py_file.stat().st_size
        print(f"  {py_file.name}: {file_size} bytes")


file_operations()

このコードでは、ファイルやディレクトリの操作を行っています。

現在のディレクトリにあるPythonファイルを見つけて、そのサイズも確認できます。 pathlibは新しいやり方で、より使いやすいと評判です。

JSONデータの処理

import json


def json_examples():
    """JSON操作の例"""
    
    # PythonオブジェクトをJSON文字列に変換
    user_data = {
        "name": "田中太郎",
        "age": 30,
        "email": "tanaka@example.com",
        "hobbies": ["読書", "映画鑑賞", "プログラミング"]
    }
    
    json_string = json.dumps(user_data, ensure_ascii=False, indent=2)
    print("JSON文字列:")
    print(json_string)
    
    # JSON文字列をPythonオブジェクトに変換
    parsed_data = json.loads(json_string)
    print(f"
解析結果: {parsed_data['name']}さん（{parsed_data['age']}歳）")


json_examples()

JSONは、データを保存したり他のプログラムと連携するときによく使われる形式です。

json.dumps()でPythonのデータをJSON形式に変換できます。 json.loads()でJSON形式のデータをPythonで使える形に戻せます。

乱数生成

import random


def random_examples():
    """乱数生成の例"""
    
    print("=== 乱数生成例 ===")
    print(f"0-1の乱数: {random.random():.3f}")
    print(f"1-10の整数: {random.randint(1, 10)}")
    
    # リストからランダム選択
    colors = ["赤", "青", "緑", "黄", "紫"]
    print(f"ランダムな色: {random.choice(colors)}")
    
    # リストをシャッフル
    numbers = [1, 2, 3, 4, 5]
    random.shuffle(numbers)
    print(f"シャッフル後: {numbers}")
    
    # 複数要素をランダム選択
    selected = random.sample(colors, 3)
    print(f"3色選択: {selected}")


random_examples()

randomモジュールを使うと、ゲームやシミュレーションで使う乱数を簡単に生成できます。

リストからランダムに選んだり、順番をシャッフルしたりできて便利です。

from文をもっと詳しく知ろう

from文を使うことで、モジュールの特定の部分だけを効率的に使えます。

from文の基本パターン

# from文の様々なパターン


# 1. 特定の関数のみインポート
from math import sqrt, pow, ceil, floor


def math_calculations():
    """数学関数の使用例"""
    number = 15.7
    
    print(f"元の数値: {number}")
    print(f"平方根: {sqrt(number):.2f}")
    print(f"2乗: {pow(number, 2):.2f}")
    print(f"切り上げ: {ceil(number)}")
    print(f"切り下げ: {floor(number)}")


math_calculations()

このコードでは、mathモジュールから必要な関数だけを取り出しています。

math.sqrt()ではなく、sqrt()だけで使えるので簡潔に書けます。

複数モジュールから選択的にインポート

# 2. 複数モジュールから選択的インポート
from datetime import datetime, timedelta
from pathlib import Path
from json import loads, dumps


def selective_imports():
    """選択的インポートの例"""
    
    # 現在時刻から1週間後
    future_date = datetime.now() + timedelta(weeks=1)
    
    # データをJSON形式で処理
    data = {"date": future_date.isoformat(), "description": "1週間後"}
    json_data = dumps(data, indent=2)
    parsed_data = loads(json_data)
    
    print(f"JSON処理結果: {parsed_data}")


selective_imports()

必要な機能だけを選んでインポートすると、プログラムが読みやすくなります。

from文のベストプラクティス

良い使い方と悪い使い方を比較してみましょう。

❌ 悪い例：ワイルドカードインポート

# これは避けましょう
# from math import *
# from statistics import *


# どの関数がどのモジュールから来たか分からなくなる

*を使うと全ての機能が読み込まれますが、どこから来た機能か分からなくなります。

✅ 良い例：明示的なインポート

from math import pi, sqrt
from statistics import mean, median


def clear_imports():
    """明示的なインポートの例"""
    numbers = [1, 4, 9, 16, 25]
    
    # どの関数を使っているか明確
    avg = mean(numbers)
    med = median(numbers)
    
    print(f"平均: {avg}, 中央値: {med}")
    print(f"平方根の平均: {sqrt(avg):.2f}")


clear_imports()

必要な機能だけを明示的にインポートすることで、コードが読みやすくなります。

as文で使いやすい名前をつけよう

as文を使ってモジュールや関数に別名を付けることができます。

エイリアスの活用例

# as文によるエイリアスの例


# 1. 長いモジュール名の短縮
import datetime as dt
import math as m


def short_aliases():
    """短いエイリアスの例"""
    
    # 短い名前で使用可能
    now = dt.datetime.now()
    pi_value = m.pi
    
    print(f"現在時刻: {now}")
    print(f"円周率: {pi_value}")


short_aliases()


# 2. 名前の衝突を避けるエイリアス
from datetime import datetime as current_time


def avoid_conflicts():
    """名前衝突回避の例"""
    
    # current_timeは関数として使用
    now = current_time.now()
    tomorrow = now + dt.timedelta(days=1)
    
    print(f"現在: {now}")
    print(f"明日: {tomorrow}")


avoid_conflicts()

長いモジュール名を短くしたり、名前の衝突を避けたりできます。

データサイエンス分野でよく使われるエイリアス

# データサイエンス分野の標準的なエイリアス
import pandas as pd
import numpy as np


def data_science_example():
    """データサイエンスでのエイリアス使用例"""
    
    # データの作成
    data = pd.DataFrame({
        'name': ['田中', '佐藤', '山田'],
        'age': [25, 30, 35],
        'score': [85, 92, 78]
    })
    
    # 基本統計情報
    print("データの概要:")
    print(data.describe())
    
    # 平均年齢
    avg_age = np.mean(data['age'])
    print(f"平均年齢: {avg_age}歳")


data_science_example()

データサイエンスの分野では、pdやnpといった短いエイリアスがよく使われます。

これらは慣習的に使われているので、覚えておくと便利です。

自分でモジュールを作ってみよう

自分でモジュールを作成して再利用する方法を学びましょう。

基本的な自作モジュール

まず、便利な関数をまとめたモジュールを作ってみます。

# utils.py（自作モジュールファイル）
"""
ユーティリティ関数を集めたモジュール
"""


def format_currency(amount, currency="¥"):
    """金額をフォーマットする関数"""
    return f"{currency}{amount:,}"


def calculate_tax(price, tax_rate=0.1):
    """税込み価格を計算する関数"""
    tax = price * tax_rate
    total = price + tax
    return {
        "base_price": price,
        "tax": tax,
        "total": total,
        "tax_rate": tax_rate
    }


class Timer:
    """時間計測用のクラス"""
    
    def __init__(self):
        self.start_time = None
        self.end_time = None
    
    def start(self):
        """計測開始"""
        import time
        self.start_time = time.time()
        print("計測開始")
    
    def stop(self):
        """計測終了"""
        import time
        self.end_time = time.time()
        elapsed = self.end_time - self.start_time
        print(f"計測終了: {elapsed:.3f}秒")
        return elapsed


# 定数の定義
DEFAULT_TAX_RATE = 0.1

このファイルをutils.pyとして保存すると、他のプログラムから使えます。

自作モジュールの使用

# main.py（自作モジュールを使用するファイル）


# 自作モジュールのインポート
import utils
from utils import format_currency, calculate_tax, Timer


def shopping_calculator():
    """買い物計算機の例"""
    
    print("=== 買い物計算機 ===")
    
    # 商品リスト
    items = [
        {"name": "ノートPC", "price": 89800},
        {"name": "マウス", "price": 2980},
        {"name": "キーボード", "price": 5480}
    ]
    
    total_before_tax = 0
    
    print("購入商品:")
    for item in items:
        price_str = format_currency(item["price"])
        print(f"  {item['name']}: {price_str}")
        total_before_tax += item["price"]
    
    # 税計算
    tax_result = calculate_tax(total_before_tax)
    
    print(f"
小計: {format_currency(tax_result['base_price'])}")
    print(f"消費税: {format_currency(int(tax_result['tax']))}")
    print(f"合計: {format_currency(int(tax_result['total']))}")


shopping_calculator()

自作モジュールを使うことで、コードの再利用性が高まります。

一度作った便利な関数を、いろいろなプログラムで使い回せるようになります。

よくあるエラーと対処法

import文でよく発生するエラーと解決方法を確認しましょう。

ModuleNotFoundError の対処法

# ModuleNotFoundError の例と対処法


def handle_import_errors():
    """インポートエラーの対処例"""
    
    # 1. モジュールが存在しない場合
    try:
        import non_existent_module
    except ModuleNotFoundError as e:
        print(f"モジュールが見つかりません: {e}")
        print("対処法: pip install でインストールするか、モジュール名を確認してください")
    
    # 2. 条件付きインポート
    try:
        import matplotlib.pyplot as plt
        HAS_MATPLOTLIB = True
    except ImportError:
        HAS_MATPLOTLIB = False
        print("matplotlib がインストールされていません")
    
    if HAS_MATPLOTLIB:
        print("グラフ機能が利用可能です")
    else:
        print("グラフ機能は利用できません")


handle_import_errors()

このコードでは、try-except文を使ってエラーを適切に処理しています。

モジュールがインストールされていない場合でも、プログラムが止まらないようにできます。

関数レベルでの遅延インポート

def create_graph(data):
    """必要な時だけインポートする例"""
    try:
        import matplotlib.pyplot as plt
        
        plt.figure()
        plt.plot(data)
        plt.title("データグラフ")
        plt.savefig("graph.png")
        return "graph.png"
    
    except ImportError:
        print("matplotlib が必要です: pip install matplotlib")
        return None


# 使用例
data = [1, 4, 2, 8, 5, 7]
result = create_graph(data)
if result:
    print(f"グラフを保存しました: {result}")

関数の中でインポートすることで、その機能を使う時だけモジュールを読み込めます。

これにより、オプション機能として扱えるようになります。

実践的なモジュール活用例

実際のプロジェクトでのモジュール活用例を見てみましょう。

設定管理モジュール

# config.py - 設定管理モジュール
import os
from pathlib import Path


# データベース設定
DATABASE_URL = os.getenv("DATABASE_URL", "sqlite:///app.db")
DEBUG = os.getenv("DEBUG", "False").lower() == "true"


# ファイルパス設定
BASE_DIR = Path(__file__).parent
DATA_DIR = BASE_DIR / "data"
LOG_DIR = BASE_DIR / "logs"


# アプリケーション設定
APP_NAME = "Sample Application"
VERSION = "1.0.0"


print(f"{APP_NAME} v{VERSION} 設定読み込み完了")

設定をまとめて管理することで、プログラム全体の設定を一箇所で変更できます。

バリデーションモジュール

# validators.py - バリデーションモジュール
import re


def validate_email(email):
    """メールアドレスの形式をチェック"""
    pattern = r'^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$'
    return bool(re.match(pattern, email))


def validate_phone(phone):
    """電話番号の形式をチェック（日本の形式）"""
    # ハイフンや空白を除去
    cleaned = re.sub(r'[\s-]', '', phone)
    
    # 日本の電話番号パターン
    patterns = [
        r'^0\d{9,10}$',      # 固定電話
        r'^0[789]0\d{8}$',   # 携帯電話
    ]
    
    return any(re.match(pattern, cleaned) for pattern in patterns)


def validate_required_fields(data, required_fields):
    """必須フィールドのチェック"""
    errors = {}
    
    for field in required_fields:
        if field not in data or not data[field]:
            errors[field] = f"{field} は必須です"
    
    return errors

バリデーション（入力チェック）機能をモジュール化することで、いろいろな場所で再利用できます。

メインアプリケーション

# main.py - メインアプリケーション
from config import APP_NAME, VERSION
from validators import validate_email, validate_phone


def main():
    """メインアプリケーション"""
    
    print(f"{APP_NAME} v{VERSION} 開始")
    
    # ユーザー情報の検証例
    user_data = {
        "name": "田中太郎",
        "email": "tanaka@example.com",
        "phone": "090-1234-5678"
    }
    
    # バリデーション実行
    if validate_email(user_data["email"]):
        print("メールアドレス: 有効")
    else:
        print("メールアドレス: 無効")
    
    if validate_phone(user_data["phone"]):
        print("電話番号: 有効")
    else:
        print("電話番号: 無効")


if __name__ == "__main__":
    main()

複数のモジュールを組み合わせることで、機能が整理されたプログラムを作れます。

まとめ

Pythonのimport文とモジュール活用の重要なポイントをまとめます。

重要なポイントをおさらい：

  • import文の基本：モジュール全体を読み込んで再利用可能なコードを活用
  • from文の活用：特定の機能のみを効率的にインポート
  • as文の便利さ：エイリアスを付けて使いやすくできる
  • 標準ライブラリ：豊富で実用的な機能が最初から利用可能
  • 自作モジュール：独自の機能をまとめて再利用可能

import文とモジュールの活用により、効率的で保守性の高いPythonプログラムを作成できるようになります。

最初は基本的な使い方から始めて、徐々に複雑なパッケージ構成にチャレンジしてみましょう。 一度覚えてしまえば、プログラミングがとても楽になりますよ。

ぜひ実際のプロジェクトでこれらのテクニックを活用してみてくださいね！

関連記事

Python with文とは？ファイル操作を安全に行う方法

Python初心者向けにwith文の使い方を詳しく解説。ファイルの安全な読み書き、リソース管理、コンテキストマネージャーの活用法を実例で説明します。

2025年7月15日
30分

Python タプルアンパック｜複数の値を展開する基礎

Python初心者向けにタプルアンパック（分割代入）の使い方を詳しく解説。複数の戻り値の受け取り、スワップ、*演算子を使った可変長アンパックを実例で説明します。

2025年7月15日
23分

Python 文字列のreplace()入門｜文字を置き換える方法

Python初心者向けにstring.replace()メソッドの使い方を詳しく解説。文字列の置換、回数制限、複数置換、実用的なテキスト処理例を実例で説明します。

2025年7月15日
25分