【初心者向け】デバッグで意識するべき、基本の十ヶ条

デバッグ。プログラミングに内在するバグ（不具合）を除く作業です。

プログラムにはバグは必ず存在するので、デバッグ作業はプログラマーには必須の作業です。

このデバッグ作業、けっこう人によって、効率の差が顕著に出ます。

• 初心者プログラマーが、３日かかったデバッグ作業を
• ベテランプログラマーなら、３分で解決する

こんなことも、ザラに起こります。

何が違うのでしょう？デバッグには、意識すべき基本の心得があるのです。

こんなデバッグはいけない

プログラミング初心者は、バグに遭遇すると、軽くパニックになりますよね。

そして、おもむろにコードをいじり始めます。

でもなかなか直りません。それどころか、

そして、泥沼にはまっていくのです。

デバッグには、それなりのお作法や心得が、あるのです。

デバッグにおける、基本の十ヶ条

デバッグには、心得ておくべき基本事項が、いくつもあります。最も基本は、次にあげる十ヶ条。

順番に見ていきましょう。

デバッグを始めるまえの心得

プログラムにバグが発生！さっそくデバッグ開始・・・の前に、ちょっと待って。

バグが発生したからといって、すぐにコードをさわり始めるのはNGです。

なにごとも、準備が大切。それにより、後の混乱が防げます。

（１）再現方法を確かめておく

デバッグした後は、ほんとうにバグが直っているのか、確かめる必要があります。

確かめ方はこうですね。直す前とまったく同じことをして、ちゃんと動作するか。

つまり、どういう手順でやったらバグが起こるのか、事前に確認しておくことが大事です。

特に、このようなときは要注意。

必ず、バグが再現できる手順を確認しておきましょう。

（２）ログやトレースを確認しておく

デバッグとは、バグがありそうな箇所を推理する作業、といえるでしょう。

推理に重要なのは、証拠です。

バグの状況が再現できたら、あらかじめ証拠を集めておきます。

いろいろなものを証拠として集めておきましょう。

特に、再現しにくいバグの場合、ログやトレースで内部状態を追跡することも重要になってきます。

忘れずに収集しておきましょう。

（３）仮説を立てる

デバッグを始めるための、証拠が揃いました。

次に重要なことは、証拠をもとに仮説を立てること。

仮説を立てることにより、調査箇所をあらかじめ絞り込みます。そうしないと、後の作業がとりとめもないものになってしまいます。

デバッグ中の心得

それでは、いよいよデバッグの開始です。

仮説に基づき、なぜバグが起こるのかを明らかにしつつ、コードを直していきます。

といっても、

やみくもにコードに手を出してはいけません。状況を見ながら、少しずつ進めます。

（４）推測ではなく事実を確認する

デバッグのとき、一番厄介となる敵。それは一体何でしょう？

それは、「思い込み」です。

• ここはこう動いているだろう
• ここはこういう結果が出力されているだろう

一度そう思うと、なかなかそこから抜け出せず、泥沼にはまります。

先入観に囚われず、事実を確認しましょう。

変数の中身や実行状況を確認する用に、大抵のプログラミング言語は、デバッガを提供しています。

デバッガを使うのが難しいなら、ひたすらprint文で変数を表示しまくるのもアリですよ。（俗に言う「プリントデバッグ」）

（５）二分探索で原因箇所を絞り込む

デバッグで重要なことは、バグが起こっている箇所を特定すること。

そのときに大事な考え方が、二分探索です。

これで、バグが存在しそうな場所が、前半か後半か、半分に絞られるわけです。

範囲が絞られたら、さらにその範囲で、二分探索。

こうやって、見るべき場所を絞り込んでいき、バグの箇所を特定していくわけです。

デバッグに必要なのは、結局はこの繰り返し。

もしそれでもバグの箇所が見つからなかったら？それはおそらく、仮説が間違っていたのでしょう。あらためて仮説に立ち戻りましょう。

（６）修正は一度にひとつだけ

バグの原因が見つかったら、修正します。

このとき、複数のバグがあったとしても、修正するバグは一度にひとつだけ。

まとめて直せば効率的じゃない？と考えがちですが、こんな問題もあります。

修正を行い、テストを流し、コードを確定（コミット）する。

これをひとつひとつ、確実に行いましょう。

デバッグが終わったあとの心得

コードの修正が完了して、期待通りに動くようになりました。

そう、バグが直ったからといっても、まだまだやるべきことがあるのです。

（７）同様の修正を水平展開する

バグの原因は、割と単純なことだったりもしますね。

こういう単純なバグは、もしかしたら、他のところでも同じことをやっているかも？

同じようなバグが他の箇所にもあれば、同じように直しましょう。

こういった作業を、「横展開」とか「水平展開」と呼びます。水平展開すべき箇所はないか、確認しましょう。

（８）リグレッションテストを行う

デバッグでコードを修正したときに、注意しなければいけないのが、デグレードです。

バグを修正したら、そのバグの箇所はもちろん、その周辺のコードもテストします。デグレードが発生していないかを確認するのです。

デグレードがないことを確認するテストのことを、リグレッションテストといいます。

リグレッションテストを忘れずに行いましょう。

リグレッションテストに有効なのが、ユニットテストの仕掛けです。テストを自動化しておくと、リグレッションテストが格段にラクになります。可能であれば導入を検討してみましょう。

今後デバッグしやすくするための心得

横展開で修正し、リグレッションテストもパス。ひととおりデバッグの作業は終了です。

でも、まだ考えることがあります。それは今後のこと。

プログラムにバグがある以上、デバッグという作業はなくなりません。

でも、デバッグをラクにするために、事前にできること、はあるのです。

（９）コンパイルやリントでエラーを検出する

デバッグをラクにする方法のひとつは、バグを早く見つけること。

プログラムを動かす前にバグを見つけらるなら、それにこしたことはありません。

今のプログラミング言語では、動作する前に問題点を見つけてくれる仕掛けが、いろいろあります。

コンパイル時点で、バグの芽を早めに摘んでおく。これが深刻な不具合の防止に役立ちます。

（10）リファクタリングを考える

バグが発生しやすいコード、デバッグがしにくいコード。それは経験則として、こんなコードでしょう。

プログラムは、書き方によって簡単になったり複雑になったりします。

なので、同じことをするなら、簡単で単純なコードであるほうが、デバッグがしやすくなります。

読みやすいコードを書きましょう。読みやすければ、間違いも発見しやすくなります。

さらには、ちゃんと内部構造を改善し、分かりやすいコードに改善できるとベストです。

そういう修正のことを、リファクタリングといいます。

可能であれば、リファクタリングにも挑戦しましょう。

今後のデバッグ作業を、格段にラクにしてくれるはずです。

デバッグにAIを活用しよう

デバッグ作業は、ある意味、職人技とも言えるもの。

ですが近年では、AIの登場により、デバッグ作業は格段にラクになってきています。

例えば、このようなことができます。

これでけっこう、コードの内容やバグの原因を教えてくれたりします。

AIに聞くとき、良かれと思い「ここがおかしいと思うんだけど」みたいな情報を、あれこれ加えてしまいがち。

しかしそれが、自分の思い込みの解釈であった場合、AIをミスリードしてしまいます。

AIには、対象のコードや発生したメッセージなど、事実をありのまま伝えましょう。

デバッグにおけるAIの活用は、まだまだ発展途上です。今後さまざまな研究がなされ、進化していくでしょう。

活用しない手はないですね。

AIに入力したソースコードなどは、AIの学習に使われる可能性があります。秘匿性の高いコードなどの扱いには注意しましょう。

まとめ

実はプログラマーは、コーディングする時間と同じくらい（いやそれ以上に）デバッグに時間を費やします。

そしてデバッグ作業は、技量により、効率に圧倒的な差が出やすい作業です。

でも大丈夫、基本をおさえて経験を積めば、デバッグ技術はどんどん向上します。