体系ガイド · 入門

デバッグとテスト:原因の仮説を小さな検証に変える

再現条件、最小例、境界値、回帰テストをつなげ、偶然直った変更と原因を説明できる修正を区別します。

この記事をロゲイアに質問する確認問題3問に進むこれまでの誤答を復習する

更新日

この記事の目次
  1. 期待と観測を分ける
  2. 境界値の例で原因を絞る
  3. 修正を回帰テストへ残す
  4. 単体テストの限界
  5. テストの失敗から説明を作る
  6. この記事をロゲイアに質問する理解を確かめる

期待と観測を分ける

デバッグの出発点は「動かない」という感想ではなく、入力、期待した結果、実際の結果を並べることです。環境、実行手順、データの状態も残します。同じコードでも時刻や実行順序によって変わる不具合では、再現した一回だけを説明できる修正では不十分です。まず事実を集め、仕様の理解違いと実装の誤りを分けます。

境界値の例で原因を絞る

配列から年齢が18以上の人を選ぶ関数が、18歳の人を落とすとします。入力を17、18、19の三人だけにすると、データ取得や並び替えなどの無関係な処理を外せます。比較演算子が「より大きい」になっていないか仮説を立て、条件だけを確認します。この例では17を除き18と19を含むことが仕様なので、件数だけでなく具体的な結果を検査します。

python
def adults(ages):
    return [age for age in ages if age >= 18]

assert adults([17, 18, 19]) == [18, 19]

修正を回帰テストへ残す

再現した入力を自動テストとして残すと、後の変更で同じ境界条件が壊れたことに気づけます。テストは内部のif文をなぞるのではなく、利用者から見た振る舞いを確認します。空配列、上限値、異常な型などを追加するときも、それぞれがどの仕様や既知の失敗を守るか説明できることが大切です。大量の似たテストがあるだけでは十分とはいえません。

単体テストの限界

関数が正しくても、DBの権限、通信先の応答、画面の入力形式との接続で壊れる場合があります。原因が境界にあるなら結合テストや実環境の観測が必要です。逆に、すべてを画面操作だけで調べると原因の特定が遅くなります。小さい検証で原因を絞り、必要な範囲の通し確認で修正の効果を確かめるという順序を使います。

テストの失敗から説明を作る

境界のテストを実装前の条件へ戻すと失敗することを確かめると、検査が本当に今回の誤りを捉えているか分かります。その後、修正と関係のない条件まで変えていないか差分を読みます。結果だけ合わせる特別扱いを追加するより、17、18、19のすべてで一貫する規則を選び、別の利用者の入力でも同じ意味になることを確認します。

読了と問題の結果を、言語ごとにこのブラウザへ保存します。

コースの順番に沿って学ぶ

CS基礎を固める · STEP 12

学習コースから次を選ぶ