Python Python

Python エラー解決ガイド：初心者がよくハマる問題と対処法

約18分で読めます by ぽんたぬき
Python エラー解決ガイド：初心者がよくハマる問題と対処法

Python エラー解決ガイド：初心者がよくハマる問題と対処法

こんにちは、ぽんたぬきです🦝

Pythonを学習していると、必ずエラーに遭遇します。私も最初は赤い文字で表示されるエラーメッセージを見るたびに「また間違えた...」と落ち込んでいました。しかし、エラーは敵ではありません。エラーメッセージは、プログラムが「ここが間違っているよ」と教えてくれる親切なメッセージなのです。

この記事では、Python初心者が最も頻繁に遭遇するエラーと、その解決方法を私の実体験とともに解説します。

エラーとの向き合い方：心構えが大切

私の最初のエラー体験

Python学習を始めて2日目、こんなコードを書きました：

print("Hello World!)

結果は...

SyntaxError: EOL while scanning string literal

「何これ？英語だし、意味分からない！」と思ったのが最初の印象でした。

エラーメッセージの読み方

エラーメッセージは実は非常に親切です：

# エラーの構造
Traceback (most recent call last):  # エラーの追跡情報
  File "test.py", line 1, in <module>  # エラーが発生したファイルと行番号
    print("Hello World!)  # 問題のあるコード
                       ^  # エラーの位置を示すカーソル
SyntaxError: EOL while scanning string literal  # エラーの種類と説明

読み方のコツ：

  1. 最後の行から読む（エラーの種類）
  2. ファイル名と行番号を確認
  3. 問題のあるコードを見る
  4. カーソル（^）の位置をチェック

初心者が最も遭遇する10のエラー

1. SyntaxError：文法エラー

よくあるパターン

括弧の閉じ忘れ：

# ❌ エラーコード
print("Hello World!"
# SyntaxError: '(' was never closed

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

引用符の閉じ忘れ：

# ❌ エラーコード
message = "Hello World!
# SyntaxError: EOL while scanning string literal

# ✅ 正しいコード
message = "Hello World!"

コロン（:）の忘れ：

# ❌ エラーコード
if x > 5
    print("大きいです")
# SyntaxError: invalid syntax

# ✅ 正しいコード
if x > 5:
    print("大きいです")

私の失敗談

最初の1ヶ月間、私はSyntaxErrorを何百回も出しました。特に引用符の閉じ忘れが多く、「なんで文字が赤くなるの？」と困惑していました。

対策

  • コードエディタの括弧ハイライト機能を使う
  • 書いたらすぐに実行する習慣をつける
  • インデントを意識する

2. IndentationError：インデント（字下げ）エラー

よくあるパターン

# ❌ エラーコード
if x > 5:
print("大きいです")
# IndentationError: expected an indented block

# ✅ 正しいコード
if x > 5:
    print("大きいです")  # 4つのスペースでインデント

混在インデント：

# ❌ エラーコード（タブとスペースが混在）
if x > 5:
    print("line 1")  # 4つのスペース
	print("line 2")  # タブ文字
# IndentationError: unindent does not match any outer indentation level

# ✅ 正しいコード
if x > 5:
    print("line 1")  # 4つのスペース
    print("line 2")  # 4つのスペース

私の苦労話

Pythonを始めて最も混乱したのがインデントです。他の言語では{}を使うのに、Pythonはスペースで構造を表現する。「見た目同じなのになんでエラー？」と何度も思いました。

対策と設定

VSCodeの設定：

  • タブをスペースに変換する設定
  • インデントガイドを表示
  • 「空白文字を表示」を有効化
{
    "editor.insertSpaces": true,
    "editor.tabSize": 4,
    "editor.renderWhitespace": "all"
}

3. NameError：未定義の変数エラー

よくあるパターン

# ❌ エラーコード
print(message)
# NameError: name 'message' is not defined

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

タイプミス：

# ❌ エラーコード
my_name = "ぽんたぬき"
print(my_nama)  # 'nama'になっている
# NameError: name 'my_nama' is not defined

# ✅ 正しいコード
my_name = "ぽんたぬき"
print(my_name)

私の実体験

「message」と「massage」を間違えて1時間悩んだことがあります。エラーメッセージをよく読めば分かることなのに、当時は「なんで動かないの？」と混乱していました。

対策

  • 変数を使う前に必ず定義する
  • 変数名のスペルチェック
  • 短くて分かりやすい変数名を使う

4. TypeError：型エラー

よくあるパターン

文字列と数値の結合：

# ❌ エラーコード
age = 25
message = "私は" + age + "歳です"
# TypeError: can only concatenate str (not "int") to str

# ✅ 正しいコード（方法1：str()で変換）
age = 25
message = "私は" + str(age) + "歳です"

# ✅ 正しいコード（方法2：f-stringを使用）
age = 25
message = f"私は{age}歳です"

不適切な関数の使用：

# ❌ エラーコード
number = "123"
result = len(number) + number
# TypeError: unsupported operand type(s) for +: 'int' and 'str'

# ✅ 正しいコード
number = "123"
result = len(number) + int(number)  # int()で数値に変換

私が学んだコツ

型の違いでエラーが出たときは、type()関数で確認する習慣をつけました：

# デバッグ用のコード
value = "123"
print(type(value))  # <class 'str'>
print(type(int(value)))  # <class 'int'>

5. IndexError：インデックスエラー

よくあるパターン

# ❌ エラーコード
numbers = [1, 2, 3]
print(numbers[3])  # インデックス3は存在しない
# IndexError: list index out of range

# ✅ 正しいコード
numbers = [1, 2, 3]
print(numbers[2])  # インデックスは0から始まる

空のリストへのアクセス：

# ❌ エラーコード
empty_list = []
print(empty_list[0])
# IndexError: list index out of range

# ✅ 正しいコード
empty_list = []
if len(empty_list) > 0:
    print(empty_list[0])
else:
    print("リストが空です")

私の失敗パターン

C言語出身の友人から「配列は1から始まる」と聞いていて、Pythonでも1から始まると勘違いしていました。0から始まることを理解するまで、このエラーを何度も出しました。

6. KeyError：辞書のキーエラー

よくあるパターン

# ❌ エラーコード
person = {"name": "ぽんたぬき", "age": 45}
print(person["gender"])
# KeyError: 'gender'

# ✅ 正しいコード（方法1：事前チェック）
person = {"name": "ぽんたぬき", "age": 45}
if "gender" in person:
    print(person["gender"])
else:
    print("性別の情報がありません")

# ✅ 正しいコード（方法2：get()メソッド）
person = {"name": "ぽんたぬき", "age": 45}
gender = person.get("gender", "不明")
print(f"性別: {gender}")

7. ValueError：値エラー

よくあるパターン

# ❌ エラーコード
user_input = "hello"
number = int(user_input)
# ValueError: invalid literal for int() with base 10: 'hello'

# ✅ 正しいコード
user_input = "hello"
try:
    number = int(user_input)
    print(f"数値: {number}")
except ValueError:
    print("数値以外が入力されました")

8. AttributeError：属性エラー

よくあるパターン

# ❌ エラーコード
text = "Hello World"
text.appned("!")  # appendのスペルミス
# AttributeError: 'str' object has no attribute 'appned'

# ✅ 正しいコード
text = "Hello World"
text = text + "!"  # 文字列は+=や+で結合

9. ImportError/ModuleNotFoundError：インポートエラー

よくあるパターン

# ❌ エラーコード
import pandas
# ModuleNotFoundError: No module named 'pandas'

# ✅ 解決方法
# ターミナルで以下を実行
# pip install pandas

私の環境構築エラー体験

最初の頃、何度も「ModuleNotFoundError」に遭遇しました。「Pythonには最初から全部入ってるんじゃないの？」と思っていたのです。

対策

# よく使うパッケージのインストール
pip install pandas numpy matplotlib requests

10. FileNotFoundError：ファイルが見つからないエラー

よくあるパターン

# ❌ エラーコード
with open("data.txt", "r") as file:
    content = file.read()
# FileNotFoundError: [Errno 2] No such file or directory: 'data.txt'

# ✅ 正しいコード
import os

filename = "data.txt"
if os.path.exists(filename):
    with open(filename, "r") as file:
        content = file.read()
else:
    print(f"ファイル '{filename}' が見つかりません")

デバッグの技術：エラーを見つける方法

1. print()文を使ったデバッグ

最もシンプルで効果的な方法：

def calculate_total(prices):
    total = 0
    for price in prices:
        print(f"現在の価格: {price}, 累計: {total}")  # デバッグ出力
        total += price
    return total

prices = [100, 200, 300]
result = calculate_total(prices)
print(f"合計: {result}")

2. type()とdir()を使った調査

# 変数の型を確認
value = "123"
print(f"型: {type(value)}")
print(f"利用可能なメソッド: {dir(value)}")

3. try-except文でエラーハンドリング

def safe_divide(a, b):
    try:
        result = a / b
        return result
    except ZeroDivisionError:
        print("0で割ることはできません")
        return None
    except TypeError:
        print("数値以外が入力されました")
        return None

# テスト
print(safe_divide(10, 2))  # 5.0
print(safe_divide(10, 0))  # エラーメッセージと None
print(safe_divide(10, "a"))  # エラーメッセージと None

4. VSCodeのデバッガを使う

設定方法：

  1. VSCodeでPythonファイルを開く
  2. 行番号の左をクリックしてブレークポイントを設定
  3. F5キーでデバッグ開始
  4. 変数の値を確認しながらステップ実行

エラー対策の開発環境設定

VSCodeの推奨設定

{
    "python.linting.enabled": true,
    "python.linting.pylintEnabled": true,
    "python.formatting.provider": "black",
    "editor.formatOnSave": true,
    "python.terminal.activateEnvironment": true
}

便利な拡張機能

  1. Python - マイクロソフト公式
  2. Python Docstring Generator - ドキュメント生成
  3. Error Lens - エラーを行内に表示
  4. Bracket Pair Colorizer - 括弧の対応を色分け

リンター（コード検査ツール）の活用

# pylintのインストールと実行
pip install pylint
pylint my_script.py

# flake8のインストールと実行
pip install flake8
flake8 my_script.py

よくある質問と私の経験談

Q: エラーが出たとき、どのぐらい自分で調べるべき？

A: 私の経験では、15-20分調べて分からなかったら誰かに聞くのがベストです。

最初の頃は意地になって2-3時間調べることもありましたが、それより質問した方が効率的でした。

Q: 英語のエラーメッセージが理解できない

A: Google翻訳やDeepLを活用しましょう。また、エラーメッセージをそのままGoogleで検索すると、日本語の解説記事が見つかることが多いです。

Q: 同じエラーを何度も出してしまう

A: それは普通です！私も「また同じエラー...」ということが何度もありました。メモを取ったり、自分なりのエラー対処法リストを作るのがおすすめです。

エラーとの付き合い方：メンタル面

エラーはスキルアップのチャンス

私が学習を続けられた理由の一つは、エラーを「学習の機会」と考えるようになったことです。

考え方の変化：

  • ❌ 「また間違えた...」
  • ✅ 「新しいことを一つ学べた！」

エラー解決の記録をつける

以下のように記録をつけるのも効果的かもしれません：

日付: 2023/03/15
エラー: NameError: name 'x' is not defined
原因: 変数xを定義する前に使用
解決方法: 変数を使用する前に定義
学んだこと: 変数は使用前に必ず定義が必要

休憩の大切さ

どうしても解決できないときは、一度離れて休憩することも大切です。散歩したり、お茶を飲んだりして戻ってくると、なぜか解決策が見えることがあります。

まとめ：エラーを恐れずにPythonを楽しもう

エラー解決の基本ステップ

  1. エラーメッセージを最後まで読む
  2. エラーの種類を特定する
  3. 問題の箇所を確認する
  4. 基本的な解決策を試す
  5. それでもダメなら調べる・質問する

私からのメッセージ

Python学習を始めて2年が経ちましたが、今でも毎日エラーに遭遇します。でも今は「また新しいことを学べる！」と前向きに捉えられるようになりました。

エラーは敵ではありません。エラーは、より良いプログラマーになるための先生です。

最初は戸惑うかもしれませんが、この記事で紹介した対処法を参考にして、エラーとうまく付き合いながらPythonを楽しんでください。

「エラーを制する者は、Pythonを制する」 🦝

一緒に頑張りましょう！

関連記事

Streamlit入門 第3部：ポートフォリオ管理とアラート機能で完全な投資ツールを構築
Python

Streamlit入門 第3部：ポートフォリオ管理とアラート機能で完全な投資ツールを構築

これまでの記事で価格表示とチャート分析ができるようになりました。今回は最終回として、自分の保有している仮想通貨を管理するポートフォリオ機能と、価格変動を知らせるアラート機能を追加します。これで本格的な投資管理ツールの完成です！ ポートフォリオ管理とは？なぜ重要なのか ...

Streamlit
Streamlit入門 第2部：美しいチャートと可視化で仮想通貨を分析しよう
Python

Streamlit入門 第2部：美しいチャートと可視化で仮想通貨を分析しよう

前回の記事で基本的な価格表示ができるようになりました。今回は、プロのトレーダーが使うような美しいチャートを追加して、本格的な分析ツールに仕上げていきます。難しそうに見えますが、実は数行のコードで驚くほど高機能なチャートが作れるんです！ Plotlyとは？なぜグラフライブラリの中で最強なのか ...

Streamlit Plotly
Python Webスクレイピング 2025 第3部：実践プロジェクトとデータ管理
Python

Python Webスクレイピング 2025 第3部：実践プロジェクトとデータ管理

はじめに シリーズ最終回となる第3部では、実際のプロジェクトで使える実践的なスクレイピングシステムの構築について解説します。検出回避技術、データの永続化、監視システムの構築など、プロダクション環境で必要となる高度な技術を学びます。 また、法的・倫理的配慮についても詳しく説明し、責任あるスクレイピング...

Webスクレイピング Python

コメント

0/2000