マジックナンバー¶

良い質問です 💡
「マジックナンバー（Magic Number）」は、IT業界・プログラミングで非常によく出てくる重要な概念です。
以下でわかりやすく整理します👇

🧩 マジックナンバーとは¶

プログラムの中に 意味が明示されていない数値や文字列を直接書くこと を指します。
つまり、「何のための値かがコードを見ただけでは分からない値」のことです。

🔹 例（マジックナンバーを使っている悪い例）¶

if (status == 3) {
    System.out.println("完了しました");
}

この 3 は何を意味しているのか、コメントや定義を見ないと分かりません。
これが マジックナンバー です。

✅ 改善した書き方（定数化）¶

private static final int STATUS_COMPLETED = 3;

if (status == STATUS_COMPLETED) {
    System.out.println("完了しました");
}

3 の意味が「完了状態」だと明確になりました。
これが「マジックナンバーをなくす」＝「定数化（名前を与える）」という良い書き方です。

⚙️ マジックナンバーを使うことのデメリット¶

💡 定数化（マジックナンバー回避）のメリット¶

🧮 どんな値がマジックナンバー？¶

以下のようなものが典型的です：

🚫 例外的にマジックナンバーでも許される場合¶

• 一目で意味が明らかな「一般的な値」：

  • for (int i = 0; i < 10; i++)
  • array[0]（先頭要素）
  • Math.PI, 2, 0, 1 など基本的な数学定数

こうした場合は「読みやすさを損なわない」ので定数化は不要です。

✅ まとめ¶

💡 補足（上級者向け）

• 状態を定義する場合は enum の使用がより望ましいです：

enum Status {
    INIT, PROCESSING, COMPLETED
}

こうすれば数値定数よりも型安全に扱えます。