エラーが出たときの調べかた・直しかたの基本
エラーが出たら、まずメッセージを最後まで読む。話はそこから始まります。
慣れていないうちは、赤い文字が出た瞬間に画面を閉じたくなります。けれどエラーメッセージは、コンピュータが「どこで、何が原因で止まったか」を報告してくれている文章です。読まずに閉じるのは、道を尋ねた相手の返事を聞かずに歩き出すようなものです。
この記事では、エラーに出会ってから直すまでを、初心者がつまずきやすい順に整理します。特定の言語に限らず使える考えかたです。
エラーメッセージは「場所」と「種類」を見る
長い英語がずらっと並ぶと身構えますが、見るところはだいたい決まっています。
- 場所… ファイル名と行番号。「どのファイルの何行目で止まったか」が書いてあります
- 種類… エラーの分類名。「見つからない」「型が合わない」「書き方が違う」などの見出しにあたる部分です
- 説明… その種類に対する一行の補足
複数行にわたって表示される場合、いちばん下（または最初の1〜2行）に本題が書かれていることが多くあります。途中の行は「そこに至るまでの経路」の記録で、最初のうちは読み飛ばしても構いません。
英語で書かれていて意味が取れないときは、そのまま翻訳にかけるか、AIに貼り付けて「これは何を言っていますか」と聞けば十分です。訳し方より、どのファイルの何行目かを先に押さえるほうが効きます。
検索するときは「自分の事情」を消す
メッセージをそのままコピーして検索すると、うまくヒットしないことがあります。多くの場合、自分の環境にしか存在しない情報が混ざっているからです。
- ファイルのパス（
/Users/自分の名前/...のような部分） - 自分で付けた変数名や関数名
- 実行のたびに変わる数字
こうした部分を外して、エラーの種類と共通する文言だけを残すと、同じ問題に当たった人の記録に届きやすくなります。使っている言語やツールの名前を一つ足すのも有効です。
検索結果を読むときは、書かれた時期にも目をやってください。ツールの仕様は変わるので、古い記事の手順がそのままでは合わないことがあります。AIに聞く場合も同じで、こうした調べものの向き・不向きはAIを「調べもの」に使うときの向き・不向きに整理しています。
直すときは、一度に一つだけ変える
原因の見当がついたら、直しかたにもコツがあります。変更は一度に一つ。そして変えたらすぐ動かす。
複数箇所をまとめて直すと、うまくいったときも「どれが効いたのか」がわからず、うまくいかなかったときは「どれが悪さをしたのか」もわかりません。結果として、次に同じ場面が来ても再現できなくなります。
手が止まったときに効く、順番の決まった手当てもあります。
- 直前に自分が変えた場所へ戻る（エラーの多くは最後の変更の近くにあります）
- 綴りと記号を疑う（閉じ忘れた括弧、全角のスペース、大文字と小文字の違い）
- 動いていた状態まで戻して、小さく作り直す
3つ目は遠回りに見えますが、原因が絞れないときはいちばん早いことがあります。作業前の状態に戻せるようにしておくと、この選択肢を安心して取れます。
それでも解けないときの聞きかた
30分ほど粘っても進まないなら、人に聞くタイミングです。そのとき、次の3点を添えると答えが返ってきやすくなります。
- やろうとしたこと（何を動かしたかったのか）
- 実際に起きたこと（エラーメッセージをそのまま。要約せずに）
- すでに試したこと
「動きません」だけだと、聞かれた側は状況の確認から始めることになります。逆に言えば、この3点を書き出す過程で自分で原因に気づくことも珍しくありません。AIに相談するときも同じ形が使えます。書きかたの手触りはプログラミング未経験でも大丈夫。AIと一緒にコードを書く時代の始め方でも触れました。
まとめ
- エラーは失敗の合図ではなく、場所と原因を伝える文章として読む
- 見るのは「どのファイルの何行目か」と「エラーの種類」
- 検索は、自分の環境固有の情報を外してから
- 直すのは一度に一箇所。変えたらすぐ動かして確かめる
- 詰まったら、やろうとしたこと・起きたこと・試したことの3点を添えて聞く
エラーを読むのは、慣れの部分が大きい作業です。何度か自力で抜け出せた経験がたまると、赤い文字を見ても手が止まらなくなります。
デジタルラボ金沢では、こうした「つまずいたときにどう動くか」も含めて、ワークショップや勉強会で一緒に手を動かしています。初心者からOK、一人一人が主役という考えかたでやっているので、気になった方はお問い合わせからどうぞ。