Pythonよくあるエラー一覧と解決方法

このページ内で Ctrl + F（Mac は ⌘ + F）を押し、英語メッセージの一部を貼り付けて検索すると、該当箇所がすぐ見つかります。下の目次から種類別に探すこともできます。

if x > 0:       # コロンを追加
    print("正の数")

for i in range(5):  # コロンを追加
    print(i)

print("Hello")  # 括弧を閉じる

def greet(name):
    print("Hello")
    print(name)    # 同じ深さに揃える（スペース4つ）

if True:
    print("OK")    # ifブロック内は1段階深くインデント

message = "Hello"      # 使う前に定義する
print(message)

count = 0
total = count + 1      # 正しいスペルで

age = 25
# 方法1: str()で変換
print("年齢は" + str(age) + "歳です")

# 方法2: f-string（推奨）
print(f"年齢は{age}歳です")

def add(a, b):
    return a + b

add(1, 2)  # 引数の数を合わせる

# 変換前にチェックするか、try-except で対処
text = "abc"
try:
    num = int(text)
except ValueError:
    print(f"'{text}' は整数に変換できません")

# 小数点を含む文字列はfloat()で変換
num = float("3.14")   # 3.14
num_int = int(float("3.14"))  # 3

# アンパックの要素数を合わせる
a, b, c = [1, 2, 3]
# または
a, *rest = [1, 2, 3]  # a=1, rest=[2,3]

items = ["apple", "banana", "cherry"]

# インデックスの範囲を確認してからアクセス
i = 3
if i < len(items):
    print(items[i])
else:
    print("インデックスが範囲外です")

# 最後の要素は -1 で取得できる
print(items[-1])   # "cherry"

# 空リストチェック
if items:
    print(items[0])

person = {"name": "Alice", "age": 25}

# 方法1: get()を使う（キーがなければNoneまたはデフォルト値）
print(person.get("email"))          # None
print(person.get("email", "未設定")) # "未設定"

# 方法2: inでキーの存在を確認
if "email" in person:
    print(person["email"])
else:
    print("emailキーが存在しません")

# 方法3: try-except
try:
    print(person["email"])
except KeyError as e:
    print(f"キーが見つかりません: {e}")

nums = [3, 1, 2]
nums.sort()        # 正しいメソッド名

# Noneチェックをしてからメソッドを呼ぶ
result = []        # 初期値をリストにする
result.append(1)

# 文字列への追加は + か join を使う
text = "hello"
text = text + "!"
# または
text = "".join(["hello", "!"])

# どんなメソッドがあるか確認する方法
print(dir([]))     # リストのメソッド一覧
print(dir(""))     # 文字列のメソッド一覧

# ターミナルで pip install を実行する
# pip install requests
# pip install numpy pandas matplotlib

# インストール後に正しいスペルでインポート
import requests
import numpy as np

# インストール済みパッケージの確認
# pip list

# インポートできるか事前チェック（スクリプト内で）
try:
    import requests
except ModuleNotFoundError:
    print("requestsがインストールされていません")
    print("pip install requests を実行してください")

import os
from pathlib import Path

# 現在のディレクトリを確認
print(os.getcwd())

# ファイルの存在確認
path = Path("data.txt")
if path.exists():
    with open(path, "r", encoding="utf-8") as f:
        content = f.read()
else:
    print(f"ファイルが見つかりません: {path.resolve()}")

# try-exceptで安全に開く
try:
    with open("data.txt", "r", encoding="utf-8") as f:
        content = f.read()
except FileNotFoundError as e:
    print(f"エラー: {e}")

# スクリプトと同じフォルダのファイルを確実に開く
script_dir = Path(__file__).parent
data_path = script_dir / "data.txt"

# 方法1: 事前にゼロチェック
def safe_divide(a, b):
    if b == 0:
        return None   # またはデフォルト値
    return a / b

print(safe_divide(10, 2))   # 5.0
print(safe_divide(10, 0))   # None

# 方法2: try-except
try:
    result = 10 / b
except ZeroDivisionError:
    result = 0
    print("0では割れません")

# 終了条件（ベースケース）を必ず書く
def countdown(n):
    if n <= 0:        # ベースケース
        print("終了")
        return
    print(n)
    countdown(n - 1)

countdown(5)   # 5, 4, 3, 2, 1, 終了

# 再帰が深くなる処理はループに書き換えることも検討
def countdown_loop(n):
    while n > 0:
        print(n)
        n -= 1
    print("終了")

# 再帰の上限を変更する場合（慎重に）
import sys
sys.setrecursionlimit(5000)

# Shift-JIS（cp932）で開く
with open("japanese.txt", "r", encoding="cp932") as f:
    content = f.read()

# 文字コードが不明な場合は errors='replace' か 'ignore'
with open("japanese.txt", "r", encoding="utf-8", errors="replace") as f:
    content = f.read()

# chardetで文字コードを自動検出（pip install chardet が必要）
import chardet
with open("japanese.txt", "rb") as f:
    raw = f.read()
detected = chardet.detect(raw)
encoding = detected["encoding"]
print(f"検出された文字コード: {encoding}")

content = raw.decode(encoding)

import os

# 1. 他のアプリでファイルが開いていないか確認してから実行

# 2. try-exceptで対処
try:
    with open("data.csv", "w", encoding="utf-8") as f:
        f.write("name,age\n")
except PermissionError:
    print("ファイルが他のプログラムで使用中か、権限がありません")
    print("Excelなど開いているアプリを閉じてから再実行してください")

# 3. 書き込み先を変更する
output_path = os.path.join(os.path.expanduser("~"), "output.csv")
with open(output_path, "w", encoding="utf-8") as f:
    f.write("name,age\n")

count = 0

# 方法1: global宣言を使う
def increment():
    global count
    print(count)
    count += 1

increment()  # 0
increment()  # 1

# 方法2: 引数と戻り値を使う（より良い設計）
def increment(count):
    return count + 1

count = increment(count)  # count = 1
count = increment(count)  # count = 2

# 方法3: クラスを使って状態を管理する
class Counter:
    def __init__(self):
        self.count = 0
    def increment(self):
        self.count += 1

items = iter([1, 2])

# 方法1: next()のデフォルト値を指定
print(next(items, None))   # 1
print(next(items, None))   # 2
print(next(items, None))   # None（エラーにならない）

# 方法2: try-except
items = iter([1, 2])
while True:
    try:
        item = next(items)
        print(item)
    except StopIteration:
        break

# 方法3: 普通のforループ（最も推奨）
for item in [1, 2]:
    print(item)

import math
from decimal import Decimal

# 対数スケールで計算する
log_result = 1000 * math.log(math.e)   # log(e^1000) = 1000

# Decimal モジュールで高精度計算
result = Decimal(10) ** 400   # Decimal は任意精度

# try-except で対処
try:
    result = math.exp(1000)
except OverflowError:
    result = float("inf")   # 無限大として扱う

# 方法1: ジェネレータを使う（メモリに全部展開しない）
huge_gen = range(10 ** 9)   # ジェネレータは遅延評価
for i in huge_gen:
    if i > 100:
        break

# 方法2: ファイルを1行ずつ読む
with open("large_file.txt", "r", encoding="utf-8") as f:
    for line in f:           # 1行ずつ処理
        process(line.strip())

# 方法3: pandasのchunksize（大きなCSVを分割処理）
import pandas as pd
for chunk in pd.read_csv("large.csv", chunksize=10000):
    process(chunk)

# 方法4: 不要なオブジェクトを明示的に解放
del huge_list
import gc
gc.collect()

import tkinter as tk
import threading

root = tk.Tk()
label = tk.Label(root, text="待機中")
label.pack()

def background_task():
    import time
    time.sleep(2)
    # GUIの更新はafter()経由でメインスレッドに渡す
    root.after(0, lambda: label.config(text="完了！"))

thread = threading.Thread(target=background_task, daemon=True)
thread.start()
root.mainloop()

# assertのエラーメッセージを読んで、条件を満たす値を渡す
result = divide(10, 2)   # b != 0 を満たす値を渡す

score = 85
assert 0 <= score <= 100   # OK

# 本番コードではassertの代わりにValueErrorを使うのが推奨
def divide(a, b):
    if b == 0:
        raise ValueError("bはゼロ以外の値を指定してください")
    return a / b

# assert は -O（最適化）フラグで無効化されることに注意
# python -O script.py  → assertが全て無視される

# 正しい名前でインポートする
from math import sqrt
print(sqrt(16))   # 4.0

# そのモジュールに何があるか一覧で確認する
import math
print(dir(math))  # 使える関数名の一覧が見られる

# 自作ファイル名が標準ライブラリと被っていないか確認する
# random.py → my_random.py などにリネームし、
# 古いキャッシュ（__pycache__ フォルダ）が残っていれば削除する

# Ctrl + C を受け取って、後片付けをしてから終了する
try:
    while True:
        # 長時間動かす処理など
        do_something()
except KeyboardInterrupt:
    print("\n中断されました。終了します。")
    # ここでファイルを閉じる・保存するなどの後始末を書く

# 無限ループが意図しないものなら、
# ループの終了条件（break や条件式）を見直す
count = 0
while count < 5:
    print(count)
    count += 1   # これを忘れると無限ループになる