fixing-root-causes

根本原因を修正する

デバッグ時は、症状を修正しないでください。問題をすべて根本原因までたどり、そこで修正してください。

理由： 症状への対処は積み重なります。回避策を重ねるたびにシステムの理解が難しくなり、本当のバグは残ったままです。根本原因の修正には当初より時間がかかりますが、デバッグにかかる時間全体を短縮できます。

手順：

• まず再現します
• ドキュメントとコードが食い違う場合は、ドキュメントとコードのルールに従って、どちらが誤りかを判断します
• 根本原因にたどり着くまで「なぜ」と問い続けます
• ガードを追加しないでください（クラッシュを抑えるために nil チェックを追加するのは、症状への対処です）
• 回避策を正当化するのに段落ほどのコメントが必要なら、コードに問題があります（コメントではなくコードを修正してください）
• 個別の事例だけでなく、パターンを確認します（同じパターンを grep で検索し、該当箇所をすべて修正します）
• 行き詰まったら、計測します。推測はしないでください（ログを追加し、実際のエラーを読みます）

再起動後の不具合：まずコードより状態を疑う

「再起動後に失敗する」場合は、まず古い永続状態を疑ってください。設定ファイル、キャッシュ、ロックファイル、シリアライズされた状態などが該当します。状態ファイルを消去して動作が復旧する場合は、状態の検証を修正の優先事項にしてください。