Javaの「シンボルが見つかりません（cannot find symbol）」エラーの原因と解決方法

Javaにおける「cannot find symbol（シンボルが見つかりません）」エラーは、主にコンパイル中のプログラム内で宣言されていない変数を参照しようとしたときに発生します。つまり、コンパイラが参照先の変数を認識できていない状態です。

「cannot find symbol」エラーが発生する主な原因

• 宣言されていない変数や、有効範囲（スコープ）外にある変数を使用している。
• 大文字・小文字の違い（「tutorials」と「Tutorials」は別の識別子として扱われる）や、スペルミスがある。
• パッケージ化されたクラスを、import宣言によって正しく参照していない。
• 不適切な識別子名を使用している。識別子に使えるのは英字・数字・アンダースコア（_）・ドル記号（$）のみです。例えば「hello-class」は無効な名前であり、「helloclass」とはまったく別のものとして扱われます。

コード例

public class CannotFindSymbolTest {
    public static void main(String[] args) {
        int n1 = 10;
        int n2 = 20;
        sum = n1 + n2;
        System.out.println(sum);
    }
}

実行結果（コンパイルエラー）

CannotFindSymbolTest.java:5: error: cannot find symbol
sum = n1 + n2;
^
symbol: variable sum
location: class CannotFindSymbolTest
CannotFindSymbolTest.java:7: error: cannot find symbol
System.out.println(sum);
^
symbol: variable sum
location: class CannotFindSymbolTest

エラーの解決方法

上記のプログラムでは、変数「sum」が宣言されていないため、「cannot find symbol」エラーが発生しています。このエラーを解決するには、変数sumを使用する前に、次のようにデータ型を指定して宣言する必要があります。

int sum = n1 + n2;

このように変数を事前に宣言しておくことで、コンパイラがそのシンボルを正しく認識できるようになり、エラーは解消されます。同様のエラーに遭遇した場合は、まず変数やクラス名の宣言漏れ、スペルミス、import文の不足がないかを確認するとよいでしょう。