デバッグ
Debugging
デバッグとは?
- エラー(バグ)を見つけて直す過程
- コーディング時間のかなりの部分
- '問題解決'が中核の能力
デバッグが身につくと、開発中に投げかける質問そのものが変わります。「なぜ動かないのか」という漠然としたぼやきの代わりに、「どの段階までは動き、どこから動かないのか」と範囲を絞れるようになります。再現 → 切り分け → 仮説 → 検証という四つのステップが基本ですが、この中で最初に崩れるのが再現です。毎回違う形で現れる症状は、まだ手を付ける段階ではなく、まず条件を固定することから始めるべきサインです。
エラーは大きく3つに分かれます。文法エラーは実行そのものができないので、むしろ簡単です。ランタイムエラーは特定の入力や特定の容量でだけ発生します。そして最も高くつくのは論理エラーです。エラーが一つもなく正常に動いているのに、計算結果だけが間違っている場合で、数字を直接検算するまでは誰も気づきません。テストとQAが「バグがある」ことを明らかにする仕事だとすれば、デバッグは原因の箇所を特定して直す仕事という点で役割が分かれます。
AIにデバッグを任せるときは、一緒に添えるべきものが三つあります。再現手順、エラーメッセージの全文、問題が起きたファイル名です。特にエラーメッセージは要約せず、そのまま丸ごとコピーするほうがよいです。スタックトレースの最後の一行より、途中に書かれたファイル名と行番号が決定的な手がかりになることが多いからです。修正は一度に一つだけ適用してこそ、何が効果so あったかを見分けられます。
現場で最も多い事故は、'AIが勝手に直してくれるだろう'という期待です。'動きません'とだけ投げると、AIは推測でコードを書き直し、その過程で問題なく動いていた機能まで変わってしまいます。さらに危険なのは、エラーを消すことと問題を解くことを混同することです。エラーを捕まえて黙って握りつぶすコードを入れると、画面はきれいになりますが、データは誤ったまま積み重なっていきます。手を入れる前に元に戻せる地点を保存しておかないと、三回目の修正あたりで元のコードがどんな姿だったのか、誰も覚えていられなくなります。
'バグ(bug)'という言葉は、1947年にグレース・ホッパー(Grace Hopper)のチームがコンピューターの中で実際の蛾を見つけた逸話で広く知られており、エラーを取り除く作業を'デバッグ'と呼ぶようになりました。
架空の事例でご紹介します。役職員40名規模の生活用品流通会社A社の話です。運営チームがバイブコーディングで月末精算ファイルを自動集計する社内ツールを作ったところ、アップロードボタンを押しても何も反応しない症状が2週間にわたり繰り返されました。月末のたびに2名が2日間かかりきりで、手作業で穴埋めしていたという状況でした。
- 運営チームの金代理は、最初AIに'ボタンが押せません'とだけ書いて尋ねました。異なる修正案を4回受け取って適用しましたが、症状はそのままで、むしろ合計表示が崩れてしまいました。
- チーム長が再現条件から書き直させました。'12月の精算Excel 3.2MBをアップロードすると3秒後に画面が止まる'と固定したところ、1MBのテストファイルは問題なくアップロードできることがわかりました。
- 金代理がブラウザのコンソールを開き、赤いエラーを要約せず12行の全文をそのままコピーして貼り付けました。AIはすぐにアップロード容量の上限2MBの設定1行を原因として指摘しました。
- 一度に一つずつだけ直しました。上限値を20MBに上げて保存し確認したあと、'止まったと思った'という誤解を生んでいた待機画面は進行表示の追加で別に対処しました。
- 二日かかっていた月末精算が40分に短縮され、同じ症状の再問い合わせは月3件から0件になりました。その後チームは'再現手順+エラー全文'を添えてからAIに質問する、というルールを文書に残しました。
パク・スンテ
金鍾赫