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

※本記事はアフィリエイト広告（PR）を含みます

プログラムを動かしたとき、画面に出てくる赤い文字のかたまり——それが「エラーメッセージ」です。初心者にとっては怖い存在ですが、実は「どこで・何につまずいたか」を教えてくれる親切な案内板。この記事を読めば、エラーを落ち着いて読み解く基本が身につきます。

エラーが出ても壊れたわけじゃないよ。むしろ「ここが困ってるよ」って教えてくれてるんだ。まずは深呼吸から!

エラーメッセージとは？（怖がらなくて大丈夫）

エラーメッセージとは、プログラムが「うまく動けなかった理由」を知らせてくれるお知らせのことです。パソコンが意地悪をしているわけではなく、「この場所でつまずいたよ」と、場所と原因を報告してくれています。

カーナビが「その道は通行止めです」と教えてくれるのに似ています。行き先にたどり着けないとき、黙って止まるのではなく、理由を教えてくれる。エラーメッセージも同じで、読めば読むほど「次に何を直せばいいか」が見えてきます。

よく出てくる言葉を、先に2つだけかみ砕いておきます。

エラー：処理を続けられなくなり、プログラムが止まった状態のこと。
例外（れいがい／Exception）：Pythonなどで、起きたエラーの「種類」を表す名前。NameError（名前の間違い）のように、末尾が「〜Error」で終わることが多いです。

エラーはたくさんの行が出ることがありますが、コツはひとつ。いちばん下の行がいちばん大事です。

たとえばPythonでは、こんなエラーが出ます。

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

上から順に、こう読めます。

つまり、namaeという変数を使おうとしたけれど、そんな名前は用意されていなかった——というわけです。最初は上の英語にひるみますが、まず一番下だけ読めば十分です。

全部読もうとしなくて大丈夫。「一番下の行」と「line ◯（何行目）」の2つだけ見れば、8割解決するよ。

迷ったら、この順番でたどってみてください。

この3つだけで、初心者がぶつかるエラーの多くは自力で解けるようになります。

読むだけより、1回自分で体験するのが近道です。テスト用のファイルに、次の1行だけ書いて実行してみましょう。

print(namae)

namaeという変数はどこにも用意していないので、わざとエラーになります。実行すると、先ほどのNameErrorが出るはずです。出たら、あわてずいちばん下の行を読んでみてください。「そんな名前ないよ」と言われているのがわかれば、もうエラーは怖くありません。

私も最初は、赤い文字が出ただけで「壊した!」とパソコンを閉じていました。でも「これはただの案内板」と思えてから、ぐっと前に進めるようになりました。

Q. 英語ばかりで読めません。
A. 全部を読む必要はありません。いちばん下の行だけコピーして翻訳や検索にかければ十分です。not defined（定義されていない）、not found（見つからない）など、よく出る単語から少しずつ覚えれば大丈夫です。

Q. エラーの種類が多すぎて覚えられません。
A. 覚えなくてOKです。実際によく出会うのは数種類だけ。出たときに調べる、を繰り返すうちに自然と身につきます。

Q. 検索してもよくわかりません。
A. エラーメッセージの一部（ファイル名など自分固有の部分）は消して、共通しそうな部分だけで検索すると、似た事例が見つかりやすくなります。

Q. エラーをAIに貼り付けて聞いてもいい？
A. とても有効です。エラーメッセージと、動かしたコードをセットで渡すと、原因と直し方を教えてもらいやすくなります。ただしAPIキーやパスワードは貼らないよう注意してください。

エラーメッセージは、あなたを責めるものではなく、「どこで・何につまずいたか」を教えてくれる案内板です。ポイントは3つ。

まずはprint(namae)でわざとエラーを出し、一番下の行を読むところから始めてみてください。エラーと仲良くなれれば、自動化の学習はぐっと楽しくなります。

※環境やツールのバージョンにより、表示されるメッセージは異なる場合があります。

PR: 未経験からの転職　Pythonでキャリアを変える【Python Winner】

無料カウンセリング・受講相談から参加可能、Python習得によるIT転職支援。