Pythonの代表的なエラー5選と解決策!コピペで試せる検証コード付き

【作業自動化】Python
スポンサーリンク

「あぁ、また画面がエラーになった……。英語ばっかりで何が書いてあるかさっぱりだし、私にプログラミングは向いてないのかな……」

そんなふうに感じたことはありませんか?

現場でも、エラーと向き合い修正するデバッグ作業は日常的な業務の一部です。
今回は、日常業務の自動化や学習の初期段階で特によく遭遇する代表的な5つのエラーについて、身近な例えと検証用コードを交えて分かりやすくご紹介します。

【作業自動化】Pythonの記事を見る 

代表的なエラーの種類と原因

エラーメッセージの種類(例外の名前)をあらかじめ知っておくだけで、問題箇所の特定が格段にスムーズになります。

①SyntaxError:文法の誤り

SyntaxErrorは、Pythonの文法ルールに従っていない場合に発生するエラーです。文章で例えると、句読点の抜けや「てにをは」の順序が崩れている状態です。

代表的な原因としては、if文やfor文の末尾にあるコロン(:)の忘れ、カッコの閉じ忘れ、あるいは全角スペースの混入などが挙げられます。

# 誤った例:if文の末尾にコロン(:)がない
# if True
#     print("こんにちは")

# 正しい例
if True:
    print("こんにちは")

コードを実行する前段階(文法チェック時)で検知されるため、まずはコロンやカッコの対応関係を確認することが解決への近道となります。

②NameError:未定義の変数名やスペルミス

NameErrorは、まだ定義されていない変数や関数を呼び出そうとした際に発生します。久しぶりに会った相手に見当違いの名前で話しかけてしまっているような状態ですね。

このエラーの原因の多くは、単純なアルファベットの打ち間違い(タイポ)や、大文字・小文字の誤用になります。

user_message = "お疲れ様です。"

# 誤った例:スペルミス(user_mesage)
# print(user_mesage)

# 正しい例
print(user_message)

Pythonでは大文字と小文字が厳格に区別されます。NameErrorが表示された場合は、定義した名前と呼び出している名前の綴りが一致しているかをしっかり確認してください。

③TypeError:データ型の不一致

TypeErrorは、操作しようとしているデータの種類(型)が、その処理に適していない場合に発生します。例えるなら、文字と金額の数値をそのまま足し算しようとするような不整合です。

実務で特によくあるのが、文字列型(str)と数値型(intやfloat)を「+」記号でそのまま連結しようとするケースになります。

employee_age = 28
# print("年齢は" + employee_age + "歳です")

# 解決策1:str()関数で数値を文字列に変換して連結します
print("年齢は" + str(employee_age) + "歳です")

# 解決策2:f文字列(f-string)を活用します
print(f"年齢は{employee_age}歳です")

f文字列を活用すると、型変換の手間を省きながらコードの可読性を高めることができます。

④IndexError:リストの範囲外アクセス

IndexErrorは、リストなどのシーケンス型データにおいて、存在しない位置(インデックス番号)を指定した際に発生します。3人しか並んでいない列に対して「5番目の方」と呼びかけるような状態です。

Pythonのインデックス番号は「0」から始まるため、要素数が3個の場合、指定可能なインデックスは「0」「1」「2」となります。

department_list = ["営業部", "総務部"]  # 要素数は2個(インデックスは0と1)

# 誤った例:インデックス2(3番目の要素)を指定すると範囲外エラーになります
# print(department_list[2])

# 正しい例
print(department_list[0])  # 1番目の要素(営業部)を取得
print(department_list[1])  # 2番目の要素(総務部)を取得

リストの要素数を把握する際は、len()関数を使用して事前に長さを確認すると安全に処理を行えます。

⑤ZeroDivisionError:ゼロによる除算

ZeroDivisionErrorは、数値をゼロで割ろうとした場合に発生する算術エラーです。算数の基本ルール通り、コンピューターの世界であってもゼロで割ることはできません。

売上データ集計などで、分母となる件数や金額がゼロのまま割り算を実行してしまうケースが代表例です。実務の現場では欠損値をゼロに設定した場合に起こりやすいです。

total_amount = 10000
member_count = 0

# 誤った例:
# average_amount = total_amount / member_count

# 解決策:事前に条件分岐で分母がゼロでないか確認します
if member_count > 0:
    average_amount = total_amount / member_count
    print(f"1人あたりの金額は {average_amount} 円です")
else:
    print("参加人数がゼロのため計算をスキップいたします")

エラーメッセージを味方につける読み解き方

エラーが発生した際は、慌てずに画面の一番下に表示されている行を確認することが大切です。

画面の最下行には、「エラーの種類(例外名):具体的な理由」が明記されています。その上の行には「どのファイルの何行目で発生したか」という追跡情報(Traceback)が記録されています。

まずは最下行のエラー名と理由をコピーし、Googleで検索してみたり生成AIにそのまま入力してみましょう。多くの場合、同じ課題を解決した先人たちの解決策や具体的な修正コードをすぐに見つけることができます。

プログラムのエラーは失敗ではなく、より安全で確実なコードへと磨き上げるための貴重なフィードバックになります。今回ご紹介した5つのエラーを把握しておくだけでも、画面が止まってしまった際の不安感は大幅に和らぐはずです。

一つひとつのメッセージを冷静に読み解き、楽しみながら業務自動化やプログラミングの学習を進めていきましょう!

【作業自動化】Pythonの記事を見る 


Pythonの本は種類が多すぎて、業務効率化に使えるのか見分けるのが大変ですよね。実務自動化に5年以上携わってきた私が、「デスクワークの自動化に即戦力になった本」を厳選して紹介します。失敗しない1冊を見つけたい方は、ぜひ参考にしてみてください。

この記事を書いた人
ぐー

手取り15万円の会社員でしたが、年間100万円以上節約していました。
株式投資で年間360万円以上投資し、iDeCoも併用しています。
総資産はアッパーマス層に到達しました。
資格は日商簿記3級を持っています。

このブログでは、私が実践してきた節約術やリアルな資産運用、生産性を高めるITスキルについて発信しています。

生活を豊かにするため、高配当株投資で年間配当金60万円をめざしています。
現在の年間配当金は30万円ほどです。

ゲーム・漫画・アニメなどが好きです。
一緒に資産形成をがんばりましょう!
よろしくお願いします!

ぐーをフォローする
【作業自動化】PythonITスキル
スポンサーリンク
ぐーをフォローする

コメント

タイトルとURLをコピーしました