Pythonエラー完全攻略ガイド：よくあるエラーの原因と解決策

🤔 どんな時に起こる？

Pythonではインデント（行頭の空白）の数が非常に重要で、コードのブロック構造を示します。このインデントが正しくない場合に発生します。

• if, for, defなどのブロックの開始後にインデントがない、またはインデントが足りない。
• 同じブロック内でインデントの深さが混在している（例: スペース4つとスペース2つが混ざっている）。
• 不要な箇所にインデントがある。
• タブとスペースが混在している（見た目では分かりにくい場合があるため注意）。

📝 コード例：

def greet(name):
print(f"Hello, {name}!") # インデントがない

if True:
    print("True")
  print("Still True") # インデントの深さが違う
          

💡 対処法：

• エラーメッセージで指摘された行のインデントを確認します。
• 同じブロック内のコードは、必ず同じ数のスペース（通常は4つ）または同じ数のタブでインデントします。PEP 8ではスペース4つが推奨されています。
• エディタのインデントガイド機能や、タブとスペースの可視化機能を利用すると便利です。多くのエディタには、タブをスペースに自動変換する設定があります。
• 不要なインデントがないか確認します。

# 修正後
def greet(name):
    print(f"Hello, {name}!") # 正しいインデント

if True:
    print("True")
    print("Still True") # インデントを揃える
          

🤔 どんな時に起こる？

実行しようとしている操作や関数に対して、不適切なデータ型（Type）のオブジェクトが与えられた場合に発生します。

• 数値（int, float）と文字列（str）を直接連結（+）しようとした。
• 数値計算ができない型（文字列など）に対して算術演算を行った。
• イテラブル（リストや文字列など）でないオブジェクトをforループで回そうとした。
• 関数やメソッドが期待する型と異なる型の引数を渡した。
• インデックス指定やスライスができない型（数値など）に対して[]を使おうとした。

📝 コード例：

age = 25
message = "私の年齢は" + age + "歳です。" # 文字列と数値を連結しようとしている

result = "10" / 2 # 文字列を数値で割ろうとしている
          

💡 対処法：

• エラーメッセージを確認し、どの操作でどの型が問題になっているかを把握します。
• 異なる型同士の演算や操作を行う前に、str(), int(), float()などを使って適切な型に変換します。
• 関数やメソッドに渡す引数の型が、期待されている型と一致しているか確認します。ドキュメントを確認することも有効です。
• Python 3.5以降で導入された「型ヒント」を活用すると、開発中に型の問題を検出しやすくなります。

# 修正後
age = 25
message = "私の年齢は" + str(age) + "歳です。" # ageを文字列に変換

result = int("10") / 2 # 文字列"10"を数値に変換
print(result) # 5.0
          

🤔 どんな時に起こる？

リスト、タプル、文字列などのシーケンス型オブジェクトに対して、範囲外のインデックス（要素番号）を指定してアクセスしようとしたときに発生します。

• リストの要素数を超えるインデックスを指定した（例: 要素が3つのリストmy_listに対してmy_list[3]を指定。インデックスは0から始まるので、0, 1, 2まで）。
• 空のリストやシーケンスに対してインデックスアクセスしようとした。
• 負のインデックスで、要素数を超える絶対値を指定した（例: 要素が3つのリストmy_listに対してmy_list[-4]を指定）。

📝 コード例：

colors = ["red", "green", "blue"]
print(colors[3]) # インデックスは0, 1, 2 まで。3は範囲外

empty_list = []
print(empty_list[0]) # 空のリストには要素がない
          

💡 対処法：

• アクセスしようとしているインデックスが、シーケンスの長さ（len()で取得可能）の範囲内（0 から len(シーケンス) - 1 まで）にあるか確認します。
• ループ処理などでインデックスを動的に生成している場合は、ループの範囲や条件式が正しいか確認します。
• アクセスする前に、シーケンスが空でないか、または十分な要素数を持っているかを確認する条件分岐（if len(シーケンス) > index: など）を追加します。
• try-except IndexError ブロックで処理を囲むことも有効です。

# 修正後
colors = ["red", "green", "blue"]
index = 2
if 0 <= index < len(colors): # インデックスの範囲をチェック
    print(colors[index])
else:
    print(f"インデックス {index} は範囲外です。")

empty_list = []
if empty_list: # リストが空でないことを確認
    print(empty_list[0])
else:
    print("リストは空です。")
          

🤔 どんな時に起こる？

オブジェクト（変数、クラスのインスタンスなど）に対して、存在しない属性（メソッドやインスタンス変数など）にアクセスしようとした場合に発生します。

• メソッド名や属性名のスペルミス。
• そのオブジェクトが持っていないメソッドを呼び出そうとした（例: リスト型に文字列型のメソッドupper()を使おうとする）。
• オブジェクトがNone（何も指していない状態）なのに、その属性にアクセスしようとした。
• クラスのインスタンスを作成したが、特定の属性が初期化されていない。

📝 コード例：

my_list = [1, 2, 3]
my_list.uppend(4) # "append"のスペルミス

text = "hello"
# text.reverse() # 文字列にはreverse()メソッドはない（リストにはある）

maybe_none = None
# print(maybe_none.some_attribute) # Noneには属性がない
          

💡 対処法：

• 属性名やメソッド名のスペルを確認します。大文字・小文字も区別されます。
• そのオブジェクトの型（type()で確認可能）が、呼び出そうとしているメソッドやアクセスしようとしている属性を持っているか確認します。公式ドキュメントやdir()関数で利用可能な属性一覧を確認できます。
• オブジェクトがNoneでないことを確認してから属性にアクセスします (例: if obj is not None: obj.attribute)。
• hasattr()関数を使って、オブジェクトが特定の属性を持っているか事前にチェックすることもできます。
• クラスを設計する際は、__init__メソッド内で必要な属性を確実に初期化するようにします。

# 修正後
my_list = [1, 2, 3]
my_list.append(4) # 正しいスペルに修正
print(my_list)

text = "hello"
# 文字列を逆順にするならスライスを使うなど、別の方法を検討
reversed_text = text[::-1]
print(reversed_text)

maybe_none = None
if maybe_none is not None: # Noneチェック
    print(maybe_none.some_attribute)
else:
    print("オブジェクトはNoneです。")
          

🤔 どんな時に起こる？

open()関数などでファイルを開こうとした際に、指定されたパスにファイルが存在しない場合に発生します。Python 3.3 で IOError から分離されました。

• ファイル名のスペルミス。
• ファイルパスの指定が間違っている（ディレクトリ構造が違う、絶対パス/相対パスの解釈が違うなど）。
• プログラムを実行しているカレントディレクトリ（現在の作業場所）が想定と異なり、相対パスで見つけられない。
• ファイルが実際にその場所に存在しない。

📝 コード例：

# "data.txt"が存在しない場合や、パスが間違っている場合
with open("data.txt", "r") as f:
    content = f.read()

# 相対パスで指定したが、実行場所が想定と違う場合
with open("files/config.json", "r") as f:
    pass
          

💡 対処法：

• ファイル名と拡張子のスペルが正しいか確認します。
• ファイルパスが正しいか確認します。
  • 相対パスの場合: プログラムを実行しているカレントディレクトリからの相対的な位置関係を確認します。os.getcwd()でカレントディレクトリを確認できます。スクリプトファイルの場所を基準にしたい場合は、__file__変数とos.pathモジュールを組み合わせることがあります (例: os.path.join(os.path.dirname(__file__), 'data.txt'))。
  • 絶対パスの場合: パス全体が正しいか確認します。Windowsではパス区切り文字が\ですが、Pythonコード内では/を使うか、\\とエスケープするか、raw文字列(r'C:\path\to\file')を使うのが一般的です。
• os.path.exists()関数を使って、ファイルを開く前に存在を確認することができます。
• try-except FileNotFoundError ブロックで処理を囲み、ファイルが見つからなかった場合の代替処理（例: エラーメッセージ表示、デフォルト設定の使用など）を記述します。

# 修正後 (try-exceptを使用)
import os

file_path = "data.txt"

try:
    with open(file_path, "r") as f:
        content = f.read()
        print("ファイルの内容:")
        print(content)
except FileNotFoundError:
    print(f"エラー: ファイル'{file_path}'が見つかりませんでした。")
    print(f"カレントディレクトリ: {os.getcwd()}") # デバッグ用にカレントディレクトリ表示

# ファイルの存在確認
config_path = "files/config.json"
if os.path.exists(config_path):
    with open(config_path, "r") as f:
        # 設定読み込み処理
        pass
    print(f"'{config_path}'を読み込みました。")
else:
    print(f"設定ファイル'{config_path}'が存在しません。")