Pythonエラーメッセージの読み方｜初心者向け対処法

みなさん、Pythonでプログラムを書いている時に突然エラーが出て困ったことはありませんか？

「エラーメッセージが英語で何を言っているか分からない」「どこを直せばいいのか見当もつかない」「同じエラーが何度も出てしまう」

そんな経験をしたことがある方も多いはず。でも大丈夫です！

エラーメッセージは、実はとても親切な案内役なんです。 正しい読み方を覚えることで、問題を素早く解決できるようになります。

この記事では、Python初心者が遭遇しやすいエラーメッセージの読み方と、具体的な対処法を分かりやすく解説します。一緒にエラーと上手に付き合っていきましょう！

エラーメッセージの基本的な読み方

まず、エラーメッセージの構造を理解しましょう。パニックにならずに、落ち着いて読むことが大切です。

エラーメッセージの構造

実際のエラーメッセージを見てみましょう：

# エラーが発生するコード例
print(undefined_variable)

このコードを実行すると、こんなエラーが表示されます：

Traceback (most recent call last):
  File "example.py", line 2, in <module>
    print(undefined_variable)
NameError: name 'undefined_variable' is not defined

ちょっと複雑に見えますが、実は規則的な構造になっています。一つずつ見ていきましょう。

エラーメッセージの各部分の意味

エラーメッセージは、4つの重要な部分で構成されています：

1. Traceback (most recent call last):

意味：エラーが発生するまでの処理の流れ
読み方：「最新の呼び出しから追跡」

2. File "example.py", line 2

意味：エラーが発生したファイル名と行番号
読み方：「example.pyファイルの2行目」

3. print(undefined_variable)

意味：エラーが発生した具体的なコード
読み方：「問題のあるコード行」

4. NameError: name 'undefined_variable' is not defined

意味：エラーの種類と詳細な説明
読み方：「名前エラー：変数 'undefined_variable' が定義されていません」

エラーメッセージを読む手順

エラーが出たら、この順番で読んでみてください：

エラーの種類（最後の行）を確認
エラーの説明文を読む
ファイル名と行番号を確認
問題のあるコードを特定
エラーの原因を推測
修正方法を考える

例えば、さっきのエラーメッセージなら：

NameError: name 'undefined_variable' is not defined

読み方：

NameError → 名前に関するエラー
'undefined_variable' is not defined → この変数が定義されていない
結論：undefined_variableという変数を使おうとしたが、定義されていない

原因が分かれば、対処法も見えてきます！

よく遭遇するエラーの種類と対処法

Python初心者が特によく遭遇するエラーを見ていきましょう。それぞれの特徴と対処法を覚えておけば、迷うことがありません。

SyntaxError（構文エラー）

SyntaxErrorは、文法が間違っている時に発生します。「書き方のルールを守れていない」という意味です。

よくある例1：括弧の閉じ忘れ

# エラーが発生するコード
print("Hello World"

エラーメッセージ：

SyntaxError: unexpected EOF while parsing

原因：括弧を閉じ忘れています。 対処法：括弧をちゃんと閉じる

# 正しいコード
print("Hello World")

よくある例2：コロンの忘れ

# エラーが発生するコード
if True
    print("実行されます")

エラーメッセージ：

SyntaxError: invalid syntax

原因：if文の後にコロン（:）がありません。 対処法：コロンを追加する

# 正しいコード
if True:
    print("実行されます")

よくある例3：インデントの間違い

# エラーが発生するコード
if True:
print("実行されます")

エラーメッセージ：

IndentationError: expected an indented block

原因：インデント（字下げ）が足りません。 対処法：適切にインデントする

# 正しいコード
if True:
    print("実行されます")  # 4つのスペースでインデント

NameError（名前エラー）

NameErrorは、定義されていない変数や関数を使おうとした時に発生します。

よくある例1：変数の定義忘れ

# エラーが発生するコード
print(message)

エラーメッセージ：

NameError: name 'message' is not defined

原因：変数messageが定義されていません。 対処法：変数を定義してから使う

# 正しいコード
message = "Hello World"
print(message)

よくある例2：スペルミス

# エラーが発生するコード
user_name = "田中"
print(user_naem)  # スペルミス

エラーメッセージ：

NameError: name 'user_naem' is not defined

原因：変数名のスペルが間違っています。 対処法：正しいスペルに修正する

# 正しいコード
user_name = "田中"
print(user_name)  # 正しいスペル

TypeError（型エラー）

TypeErrorは、データの型が合わない時に発生します。「数値と文字列を足そうとした」などの場合です。

よくある例1：文字列と数値の計算

# エラーが発生するコード
age = "25"
next_year = age + 1

エラーメッセージ：

TypeError: can only concatenate str (not "int") to str

原因：文字列の"25"と数値の1を足そうとしています。 対処法：型を統一する

# 正しいコード（方法1：数値に変換）
age = "25"
next_year = int(age) + 1
print(next_year)  # 26

# 正しいコード（方法2：文字列で統一）
age = "25"
next_year = age + "歳"
print(next_year)  # 25歳

よくある例2：関数の引数の型間違い

# エラーが発生するコード
numbers = [1, 2, 3]
print(len(123))  # 数値にlen()を使用

エラーメッセージ：

TypeError: object of type 'int' has no len()

原因：数値にlen()関数を使おうとしています。 対処法：適切な型のデータを使う

# 正しいコード
numbers = [1, 2, 3]
print(len(numbers))  # リストの長さを取得

ValueError（値エラー）

ValueErrorは、型は正しいけど値が不適切な時に発生します。

よくある例1：文字列を数値に変換できない

# エラーが発生するコード
text = "hello"
number = int(text)

エラーメッセージ：

ValueError: invalid literal for int() with base 10: 'hello'

原因：文字列"hello"を数値に変換しようとしています。 対処法：変換可能な文字列を使うか、エラーハンドリングを追加

# 正しいコード（方法1：変換可能な文字列）
text = "123"
number = int(text)
print(number)  # 123

# 正しいコード（方法2：エラーハンドリング）
text = "hello"
try:
    number = int(text)
except ValueError:
    print("数値に変換できません")

よくある例2：範囲外の値を指定

# エラーが発生するコード
import math
result = math.sqrt(-1)  # 負の数の平方根

エラーメッセージ：

ValueError: math domain error

原因：負の数の平方根を計算しようとしています。 対処法：適切な値を使う

# 正しいコード
import math
result = math.sqrt(4)  # 正の数を使用
print(result)  # 2.0

IndexError（インデックスエラー）

IndexErrorは、リストや文字列の範囲外にアクセスしようとした時に発生します。

よくある例：リストの範囲外アクセス

# エラーが発生するコード
fruits = ["りんご", "バナナ", "オレンジ"]
print(fruits[5])  # 5番目の要素を取得しようとする

エラーメッセージ：

IndexError: list index out of range

原因：リストは0〜2番目しかないのに、5番目にアクセスしようとしています。 対処法：適切なインデックスを使う

# 正しいコード
fruits = ["りんご", "バナナ", "オレンジ"]
print(fruits[0])  # りんご
print(fruits[1])  # バナナ
print(fruits[2])  # オレンジ

# 安全な方法：範囲チェック
if len(fruits) > 5:
    print(fruits[5])
else:
    print("5番目の要素は存在しません")

KeyError（キーエラー）

KeyErrorは、辞書に存在しないキーでアクセスしようとした時に発生します。

よくある例：存在しないキーへのアクセス

# エラーが発生するコード
student = {"name": "田中", "age": 20}
print(student["grade"])  # 存在しないキー

エラーメッセージ：

KeyError: 'grade'

原因：辞書に"grade"というキーが存在しません。 対処法：存在するキーを使うか、安全な方法でアクセス

# 正しいコード（方法1：存在するキーを使用）
student = {"name": "田中", "age": 20}
print(student["name"])  # 田中

# 正しいコード（方法2：get()メソッドを使用）
print(student.get("grade", "不明"))  # 不明

# 正しいコード（方法3：キーの存在チェック）
if "grade" in student:
    print(student["grade"])
else:
    print("成績情報がありません")

エラーの原因を見つけるデバッグ方法

エラーが発生した時の効果的なデバッグ方法を紹介します。焦らず、段階的に問題を特定していきましょう。

print文を使ったデバッグ

最もシンプルで効果的な方法は、print文を使って変数の値を確認することです。

def calculate_average(numbers):
    """平均値を計算する関数"""
    print(f"受け取った数値: {numbers}")  # デバッグ用
    
    total = 0
    for num in numbers:
        print(f"現在の数値: {num}, 合計: {total}")  # デバッグ用
        total += num
    
    average = total / len(numbers)
    print(f"平均値: {average}")  # デバッグ用
    return average

# テスト
test_numbers = [10, 20, 30]
result = calculate_average(test_numbers)

実行結果：

受け取った数値: [10, 20, 30]
現在の数値: 10, 合計: 0
現在の数値: 20, 合計: 10
現在の数値: 30, 合計: 30
平均値: 20.0

各ステップで何が起きているか確認できます。

段階的なコード実行

複雑なコードは、一部分ずつ実行して問題箇所を特定しましょう。

# 複雑なデータ処理の例
def process_user_data(users):
    """ユーザーデータを処理する関数"""
    
    # ステップ1：データの確認
    print(f"ユーザー数: {len(users)}")
    print(f"最初のユーザー: {users[0] if users else 'なし'}")
    
    # ステップ2：年齢の計算
    processed_users = []
    for user in users:
        print(f"処理中: {user['name']}")
        
        # 年齢計算
        birth_year = user['birth_year']
        current_year = 2024
        age = current_year - birth_year
        
        print(f"  生年: {birth_year}, 年齢: {age}")
        
        # 処理済みデータに追加
        processed_user = {
            'name': user['name'],
            'age': age,
            'category': '成人' if age >= 20 else '未成年'
        }
        processed_users.append(processed_user)
    
    return processed_users

# テストデータ
test_users = [
    {'name': '田中', 'birth_year': 1990},
    {'name': '佐藤', 'birth_year': 2005}
]

result = process_user_data(test_users)
print(f"
処理結果: {result}")

一つずつ確認することで、どこで問題が起きているか分かります。

try-except文を使った安全な実行

エラーが起きそうな箇所は、try-except文で囲んで安全に実行しましょう。

def safe_divide(a, b):
    """安全な除算を行う関数"""
    try:
        result = a / b
        print(f"{a} ÷ {b} = {result}")
        return result
    except ZeroDivisionError:
        print("エラー: 0で割ることはできません")
        return None
    except TypeError:
        print("エラー: 数値以外は計算できません")
        return None

# テスト
print("=== 正常なケース ===")
safe_divide(10, 2)

print("
=== エラーケース1: 0で割る ===")
safe_divide(10, 0)

print("
=== エラーケース2: 文字列を使う ===")
safe_divide("10", 2)

実行結果：

=== 正常なケース ===
10 ÷ 2 = 5.0

=== エラーケース1: 0で割る ===
エラー: 0で割ることはできません

=== エラーケース2: 文字列を使う ===
エラー: 数値以外は計算できません

エラーが発生してもプログラムが止まらず、適切に対処できます。

変数の型と値をチェックする方法

データの型や値を確認する便利な方法を紹介します。

def debug_info(variable, name="変数"):
    """変数の詳細情報を表示する関数"""
    print(f"=== {name}の情報 ===")
    print(f"値: {variable}")
    print(f"型: {type(variable)}")
    print(f"長さ: {len(variable) if hasattr(variable, '__len__') else 'N/A'}")
    print(f"True/False: {bool(variable)}")
    print()

# 様々な型の変数をテスト
debug_info("Hello", "文字列")
debug_info([1, 2, 3], "リスト")
debug_info({"name": "田中"}, "辞書")
debug_info(0, "数値")
debug_info(None, "None")

実行結果：

=== 文字列の情報 ===
値: Hello
型: <class 'str'>
長さ: 5
True/False: True

=== リストの情報 ===
値: [1, 2, 3]
型: <class 'list'>
長さ: 3
True/False: True

=== 辞書の情報 ===
値: {'name': '田中'}
型: <class 'dict'>
長さ: 1
True/False: True

=== 数値の情報 ===
値: 0
型: <class 'int'>
長さ: N/A
True/False: False

=== Noneの情報 ===
値: None
型: <class 'NoneType'>
長さ: N/A
True/False: False

これで変数の状態を詳しく確認できます。

実践的なエラー対処の流れ

実際にエラーが発生した時の対処手順を、具体例とともに説明します。

エラー発生時の対処手順

エラーが出た時は、この順番で対処しましょう：

落ち着いてエラーメッセージを読む
エラーの種類を特定する
発生箇所を確認する
原因を推測する
修正を試す
テストで確認する

実際の例：データ処理でエラーが発生

実際のエラー対処の流れを見てみましょう。

初期のコード（エラーあり）

def process_scores(score_list):
    """成績データを処理する関数"""
    total = 0
    count = 0
    
    for score in score_list:
        total += score
        count += 1
    
    average = total / count
    return average

# テストデータ
test_scores = []  # 空のリスト
result = process_scores(test_scores)
print(f"平均点: {result}")

エラーメッセージ

ZeroDivisionError: division by zero

対処手順

ステップ1：エラーメッセージを読む

エラーの種類：ZeroDivisionError
意味：0で割ろうとしている

ステップ2：原因を特定

空のリストを渡したため、count = 0
total / count で 0 ÷ 0 になってしまった

ステップ3：修正版を作成

def process_scores(score_list):
    """成績データを処理する関数（修正版）"""
    # 空のリストをチェック
    if not score_list:
        print("エラー: 成績データがありません")
        return None
    
    total = 0
    count = 0
    
    for score in score_list:
        # 数値かどうかチェック
        if isinstance(score, (int, float)):
            total += score
            count += 1
        else:
            print(f"警告: '{score}'は数値ではありません（スキップ）")
    
    # 有効な数値がない場合をチェック
    if count == 0:
        print("エラー: 有効な数値がありません")
        return None
    
    average = total / count
    return average

# テスト
print("=== テスト1: 空のリスト ===")
result1 = process_scores([])
print(f"結果: {result1}")

print("
=== テスト2: 正常なデータ ===")
result2 = process_scores([80, 90, 70])
print(f"結果: {result2}")

print("
=== テスト3: 混合データ ===")
result3 = process_scores([80, "無効", 90, None, 70])
print(f"結果: {result3}")

実行結果：

=== テスト1: 空のリスト ===
エラー: 成績データがありません
結果: None

=== テスト2: 正常なデータ ===
結果: 80.0

=== テスト3: 混合データ ===
警告: '無効'は数値ではありません（スキップ）
警告: 'None'は数値ではありません（スキップ）
結果: 80.0

エラーが解決され、様々な状況に対応できるようになりました！

複雑なエラーの対処例

もう少し複雑な例も見てみましょう。

初期のコード（複数のエラーあり）

def analyze_students(students):
    """学生データを分析する関数"""
    results = {}
    
    for student in students:
        name = student["name"]
        scores = student["scores"]
        
        # 平均点の計算
        average = sum(scores) / len(scores)
        
        # 成績判定
        if average >= 90:
            grade = "A"
        elif average >= 80:
            grade = "B"
        elif average >= 70:
            grade = "C"
        else:
            grade = "D"
        
        results[name] = {
            "average": average,
            "grade": grade
        }
    
    return results

# テストデータ（問題のあるデータ）
test_students = [
    {"name": "田中", "scores": [85, 90, 78]},
    {"name": "佐藤", "scores": []},  # 空のリスト
    {"name": "鈴木"},  # scoresキーがない
    {"name": "高橋", "scores": [80, "無効", 90]}  # 不正な値
]

result = analyze_students(test_students)
print(result)

エラーを段階的に修正

def analyze_students(students):
    """学生データを分析する関数（修正版）"""
    results = {}
    
    for i, student in enumerate(students, start=1):
        print(f"
=== 学生{i}の処理 ===")
        
        # 名前の確認
        if "name" not in student:
            print("エラー: 名前が設定されていません（スキップ）")
            continue
        
        name = student["name"]
        print(f"名前: {name}")
        
        # 成績データの確認
        if "scores" not in student:
            print(f"エラー: {name}さんの成績データがありません（スキップ）")
            continue
        
        scores = student["scores"]
        print(f"元の成績データ: {scores}")
        
        # 有効な成績のみ抽出
        valid_scores = []
        for score in scores:
            if isinstance(score, (int, float)) and 0 <= score <= 100:
                valid_scores.append(score)
            else:
                print(f"  警告: '{score}'は無効な成績です（スキップ）")
        
        print(f"有効な成績: {valid_scores}")
        
        # 有効な成績がない場合
        if not valid_scores:
            print(f"エラー: {name}さんの有効な成績がありません（スキップ）")
            continue
        
        # 平均点の計算
        average = sum(valid_scores) / len(valid_scores)
        print(f"平均点: {average:.1f}")
        
        # 成績判定
        if average >= 90:
            grade = "A"
        elif average >= 80:
            grade = "B"
        elif average >= 70:
            grade = "C"
        else:
            grade = "D"
        
        print(f"成績: {grade}")
        
        results[name] = {
            "average": round(average, 1),
            "grade": grade,
            "valid_scores": valid_scores
        }
    
    return results

# テスト実行
print("=== 学生データ分析 ===")
result = analyze_students(test_students)
print(f"
=== 最終結果 ===")
for name, data in result.items():
    print(f"{name}: 平均{data['average']}点 ({data['grade']})")

実行結果：

=== 学生データ分析 ===

=== 学生1の処理 ===
名前: 田中
元の成績データ: [85, 90, 78]
有効な成績: [85, 90, 78]
平均点: 84.3
成績: B

=== 学生2の処理 ===
名前: 佐藤
元の成績データ: []
有効な成績: []
エラー: 佐藤さんの有効な成績がありません（スキップ）

=== 学生3の処理 ===
名前: 鈴木
エラー: 鈴木さんの成績データがありません（スキップ）

=== 学生4の処理 ===
名前: 高橋
元の成績データ: [80, '無効', 90]
  警告: '無効'は無効な成績です（スキップ）
有効な成績: [80, 90]
平均点: 85.0
成績: B

=== 最終結果 ===
田中: 平均84.3点 (B)
高橋: 平均85.0点 (B)

問題のあるデータも適切に処理できるようになりました！

まとめ

Pythonのエラーメッセージの読み方と対処法について詳しく解説しました。

重要なポイント：

エラーメッセージは親切な案内役
構造を理解すれば読みやすい
段階的なデバッグが効果的
try-except文で安全に処理

よく遭遇するエラーの種類：

SyntaxError：文法の間違い
NameError：変数の定義忘れ
TypeError：データ型の不一致
ValueError：値が不適切
IndexError：範囲外アクセス
KeyError：存在しないキー

効果的なデバッグ方法：

print文で変数の値を確認
段階的にコードを実行
try-except文で安全に処理
型と値の詳細情報を取得

エラーは決して敵ではありません。むしろ、コードの問題点を教えてくれる頼もしい味方なんです。

エラーメッセージを恐れずに、落ち着いて読み解く習慣をつけましょう。最初は時間がかかるかもしれませんが、慣れてくると素早く原因を特定できるようになります。

ぜひ実際のプログラミングでこれらのテクニックを試してみてください！エラーと上手に付き合えるようになれば、Pythonプログラミングがもっと楽しくなるはずです。

エラーメッセージの基本的な読み方

エラーメッセージの構造

エラーメッセージの各部分の意味

エラーメッセージを読む手順

よく遭遇するエラーの種類と対処法

SyntaxError（構文エラー）

よくある例1：括弧の閉じ忘れ

よくある例2：コロンの忘れ

よくある例3：インデントの間違い

NameError（名前エラー）

よくある例1：変数の定義忘れ

よくある例2：スペルミス

TypeError（型エラー）

よくある例1：文字列と数値の計算

よくある例2：関数の引数の型間違い

ValueError（値エラー）

よくある例1：文字列を数値に変換できない

よくある例2：範囲外の値を指定

IndexError（インデックスエラー）

よくある例：リストの範囲外アクセス

KeyError（キーエラー）

よくある例：存在しないキーへのアクセス

エラーの原因を見つけるデバッグ方法

print文を使ったデバッグ

段階的なコード実行

try-except文を使った安全な実行

変数の型と値をチェックする方法

実践的なエラー対処の流れ

エラー発生時の対処手順

実際の例：データ処理でエラーが発生

初期のコード（エラーあり）

エラーメッセージ

対処手順

複雑なエラーの対処例

初期のコード（複数のエラーあり）

エラーを段階的に修正

まとめ

関連記事

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

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

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