VCA

AIのコードが壊れたら:デバッグ入門

AIが書いたコードは一発で正しいとは限らない。エラーを読み、範囲を狭め、正しい手がかりをAIに返す——初心者のための体系的デバッグ法。

公開日 更新日 レビュー日 約2分で読了編集方針#実践ガイド#デバッグ#AI協働

ひとことで言うと

デバッグは当てずっぽうではなく「範囲を狭めて、正しい手がかりをAIに返す」こと。これを覚えればAIは直せる。

作れるもの

壊れたコードに対する決まった手順:エラーの読み方、範囲の狭め方、AIに渡す手がかりの作り方。

壊れるのは普通

AIが書いたコードは一発で正しいとは限りません——あなたのせいではなく、普通のことです。違いは、デバッグできる人は直せて、できない人はAIに「もう一度」と繰り返して散らかすこと。デバッグはひらめきではなく、学べる体系的な方法です。

第1歩:エラーメッセージを読む(飛ばさない)

壊れると、画面やブラウザの Console(コンソール) に赤いエラーが出ます。初心者にありがちな失敗は、赤字に慌ててすぐAIに「壊れた」と貼ること。まず自分で読む:エラーはたいていどのファイル・何行目・何の問題かを直接教えてくれます。分からなくてよいので、全文を控えましょう。

第2歩:範囲を狭める(二分法)

全体を一度に睨まない。問う:「最後に動いたのはいつ?今回何を変えた?」疑わしい範囲を半分に切る——怪しい一部を外す/コメントアウトして、まだ壊れるか確認。小さな範囲で安定して再現できれば、原因はすぐ掴めます。

第3歩:正しい手がかりをAIに返す

AIが直せないのは、たいてい渡した情報が少なすぎるから。次の3つをまとめて渡すと命中率が上がります:

  • エラーメッセージ全文(「壊れた」ではなく全体)。
  • 再現手順:何をすると起きるか、期待と実際。
  • すでに試したこと:AIが試して効かなかった方法を繰り返さないように。

よくある落とし穴

  • 一度に変えすぎる:壊れたとき、どの変更が原因か分からない。一度に1か所、変えたらテスト。
  • Console を開かない:多くのエラーはコンソールにだけ出て、画面は「何となく変」に見えるだけ。
  • 無限の「もう一度」:AIが直せないなら、一歩引いて自分で範囲を狭め、新しい手がかりを渡す方が有効。

次のステップ

よくある質問

AIが同じバグをずっと直せないときは?

無限の「もう一度」に陥らないこと。一歩引いて自分で範囲を狭め(二分法で原因の箇所を特定)、「エラー全文+再現手順+試したこと」をまとめて渡す。情報が具体的なほどAIは直せます。「まだ壊れてる」だけではほぼ堂々巡り。

エラーメッセージが分からなくてもデバッグできる?

できます。一字一句分からなくてよいですが、**全文**を控えてAIに渡す——たいてい読めます。エラー自体より有用なのは「どう操作すると起きる・期待・実際」の再現手順。これを一緒に渡すと命中率が最も高い。

参考資料

  1. Chrome DevToolsGoogle
  2. JavaScript error reference — MDNMozilla