はじめに (対象読者・この記事でわかること)

この記事は、Javaプログラミングを始めたばかりの方や、複数のクラスを扱う際に「パッケージが見つかりません」というコンパイルエラーに遭遇してお困りの方を対象にしています。

Javaの外部クラスをインポートしようとした際に表示されるこのエラーは、多くの初学者が直面する一般的な問題です。この記事を読むことで、Javaにおけるパッケージの基本的な概念、そしてCLASSPATHの役割を深く理解し、「パッケージが見つかりません」というエラーの根本原因を特定し、ご自身で解決できるようになります。

よくあるエラーメッセージと具体的な解決策をステップバイステップで解説しますので、もうこのエラーに悩まされることはなくなるでしょう。

前提知識

この記事を読み進める上で、以下の知識があるとスムーズです。 - Javaの基本的な文法（クラス、メソッド、変数など） - コマンドライン（ターミナルやコマンドプロンプト）での基本的な操作

Javaにおけるパッケージとコンパイルの基本

Javaのパッケージは、関連するクラスやインターフェースをグループ化するための仕組みです。ちょうどコンピューターのファイルシステムにおけるフォルダーのようなもので、クラスの整理、名前の衝突回避、アクセス制御といった重要な役割を果たします。例えば、java.utilパッケージにはユーティリティクラスが、java.ioパッケージには入出力関連のクラスが含まれています。

Javaプログラムをコンパイルする際には、javacコマンドを使用します。このコマンドはソースコード（.javaファイル）をバイトコード（.classファイル）に変換します。javacがソースコード内のimport文やパッケージ宣言を解釈する際、参照しているクラスファイルがどこにあるのかを探します。この「探す場所」を決定するのが、CLASSPATHという概念です。CLASSPATHは、javacやjavaコマンドがクラスファイルを検索するためのパスを指定するもので、明示的に指定しない場合、通常はカレントディレクトリやJRE/JDKの標準ライブラリが参照されます。パッケージを使用する際は、このCLASSPATHとソースファイルのディレクトリ構造が非常に重要になります。

外部クラスの参照エラー「パッケージが見つかりません」の深掘りと解決策

Javaで外部クラスを参照しようとした際に「パッケージが見つかりません」というエラーが発生する主な原因は、ソースコードのパッケージ宣言と実際のディレクトリ構造の不一致、またはコンパイル時にクラスファイルが見つからない（CLASSPATHの設定ミス）のどちらか、あるいは両方です。具体的なシナリオを通じて、この問題と解決策を深掘りしていきましょう。

ステップ1: 問題の再現とエラーメッセージの確認

まずは、意図的にエラーを発生させる簡単なコード例を見てみましょう。 以下のようなシンプルなプロジェクト構造を想定します。

myproject/
├── src/
│   ├── com/
│   │   └── example/
│   │       └── util/
│   │           └── MyUtil.java
│   └── Main.java

MyUtil.java:

Java

// src/com/example/util/MyUtil.java
package com.example.util; // パッケージ宣言

public class MyUtil {
    public static void printMessage() {
        System.out.println("Hello from MyUtil!");
    }
}

Main.java:

Java

// src/Main.java
// import com.example.util.MyUtil; // 本来は必要

public class Main {
    public static void main(String[] args) {
        // MyUtil.printMessage(); // コメントアウトしてエラーを再現
        System.out.println("Main program started.");
    }
}

ここで、Main.javaからMyUtilクラスを参照しようとして、import com.example.util.MyUtil; の行をコメント解除し、MyUtil.printMessage(); も有効にしたとします。

誤ったコンパイル例1: srcディレクトリ内でjavac Main.javaを実行

myproject/src ディレクトリに移動して、以下のコマンドを実行します。

Bash

cd myproject/src
javac Main.java

すると、以下のようなエラーメッセージが表示されるはずです。

Main.java:3: エラー: パッケージcom.example.utilは存在しません
import com.example.util.MyUtil;
       ^
Main.java:7: エラー: シンボルを見つけられません
        MyUtil.printMessage();
        ^
  シンボル:   クラス MyUtil
  場所: クラス Main
エラー2個

これは「com.example.utilというパッケージが見つからない」という明確なエラーです。

ステップ2: エラーの原因を特定する

このエラーが発生する主な原因は以下の2つです。

1. ディレクトリ構造とパッケージ宣言の不一致: Javaのパッケージは、物理的なディレクトリ構造と完全に一致している必要があります。 package com.example.util;と宣言されたクラスは、ソースルートディレクトリの直下にcom/example/util/というディレクトリパスで配置されていなければなりません。 上記例では src/com/example/util/MyUtil.java となっており、これは正しい配置です。しかし、コンパイル時にjavacがどこを「ソースルート」として認識しているかが問題になります。

2. CLASSPATHの設定不足または誤り: javacコマンドは、import文で指定されたクラスを探す際、デフォルトではカレントディレクトリとJRE/JDKの標準ライブラリを検索します。もし参照したいクラスのソースファイルや、既にコンパイルされた.classファイルがjavacの検索パス（CLASSPATH）に含まれていない場合、「パッケージが見つかりません」というエラーが発生します。

ハマった点やエラー解決

多くの初学者がこのエラーでつまずくポイントは、「javacコマンドをどこで実行するか」と「どのようにCLASSPATHを指定するか」にあります。

• パッケージ宣言があるのに、パッケージのルートではない場所からコンパイル: 例えば、MyUtil.javaがsrc/com/example/util/にあるのに、src/com/example/util/ディレクトリに移動してjavac MyUtil.javaを実行すると、MyUtil.java自体はコンパイルできますが、このクラスを参照する別のクラス（例:Main.java）を別の場所からコンパイルしようとしたときに、com.example.utilパッケージが見つからなくなることがあります。これは、コンパイルされたMyUtil.classがutilディレクトリ直下に生成され、com/example/utilというパッケージ構造がjavacによって認識されていないためです。

• CLASSPATHにコンパイル済みクラスのルートディレクトリを含め忘れる: MyUtil.classが生成されたとしても、その.classファイルが格納されているディレクトリの親ディレクトリ（パッケージのルートとなるディレクトリ）をCLASSPATHに含めなければ、javacやjavaはそのクラスを見つけることができません。

• コンパイルは通ったが、実行時にNoClassDefFoundError: コンパイルは成功したものの、javaコマンドでプログラムを実行しようとしたときに「NoClassDefFoundError」が出る場合があります。これは、コンパイル時にはクラスパスが正しくても、実行時にjavaコマンドがクラスファイルを見つけられない場合に発生します。原因はCLASSPATHの設定ミスで、コンパイル時と実行時でCLASSPATHの設定が異なることが原因です。

解決策

「パッケージが見つかりません」エラーの解決策は、以下の原則に従うことです。

1. ソースファイルの配置とパッケージ宣言を完全に一致させる。
2. コンパイル時と実行時に、パッケージのルートディレクトリをCLASSPATHに含める。

具体的な解決策は以下の通りです。

解決策1: -dオプションとソースルートの利用（推奨）

Javaプロジェクトでは、ソースコード（.java）とコンパイル済みクラスファイル（.class）を別のディレクトリに配置するのが一般的です。javacコマンドの-dオプションを使用すると、コンパイル後の.classファイルの出力先ディレクトリを指定でき、同時にパッケージ構造も自動的に作成してくれます。

前述のプロジェクト構造で、myprojectディレクトリにいるとします。

myproject/
├── src/
│   ├── com/
│   │   └── example/
│   │       └── util/
│   │           └── MyUtil.java
│   └── Main.java
├── classes/  <-- ここに.classファイルを出力する

1. classesディレクトリを作成: bash mkdir myproject/classes

2. myprojectディレクトリでコンパイル: javacコマンドの-dオプションで出力先を指定し、ソースファイルのパスはsrcディレクトリを起点として指定します。 bash # すべてのJavaファイルをまとめてコンパイルする場合 javac -d classes src/com/example/util/MyUtil.java src/Main.java または、Main.javaがcom.example.appパッケージに属していると仮定する場合： src/com/example/app/Main.java ```bash # src/com/example/app/Main.java package com.example.app;

   import com.example.util.MyUtil;

   public class Main { public static void main(String[] args) { System.out.println("Main program started."); MyUtil.printMessage(); } } この場合、コンパイルコマンドは次のようになります。bash

   myprojectディレクトリで実行

   javac -d classes src/com/example/util/MyUtil.java src/com/example/app/Main.java `` これにより、myproject/classesディレクトリの下にcom/example/util/MyUtil.classとcom/example/app/Main.class`が生成されます。

   ポイント: javacに渡すソースファイルパスは、srcディレクトリを基準として正しく指定する必要があります。src/com/example/util/MyUtil.javaのように、パッケージ宣言のルートから始まるパスを指定します。

3. プログラムの実行: 実行時には、javaコマンドに-cp（または--class-path）オプションを使って、コンパイル済みクラスファイルが格納されているルートディレクトリ（この場合はclasses）を指定します。 bash # myprojectディレクトリで実行 java -cp classes com.example.app.Main 出力: Main program started. Hello from MyUtil!

   これで、javaコマンドがclassesディレクトリをCLASSPATHとして認識し、その中のcom.example.app.Mainクラスとcom.example.util.MyUtilクラスを見つけることができるようになります。

解決策2: IDE (IntelliJ IDEA, Eclipse, VS Code) の利用

普段コマンドラインでJavaをコンパイル・実行しない場合は、IntelliJ IDEA、Eclipse、Visual Studio Codeなどの統合開発環境（IDE）を利用することをお勧めします。これらのIDEは、プロジェクトを作成する際に自動的に正しいディレクトリ構造、CLASSPATH、ビルドパスを設定してくれます。

• IntelliJ IDEA / Eclipse: プロジェクトを作成し、ソースコードをsrcディレクトリ以下に配置するだけで、IDEが自動的にコンパイルと実行に必要な設定を管理してくれます。パッケージ宣言とファイルパスの不一致も、IDEがリアルタイムでエラーとして指摘してくれます。
• Visual Studio Code: Java Extension Packをインストールし、MavenやGradleなどのビルドツールを使ったプロジェクトを作成すれば、同様にCLASSPATHの管理やコンパイルが自動化されます。

IDEは、これらの低レベルな設定を意識することなく開発に集中できる強力なツールです。

まとめ

本記事では、Javaプログラミングにおける「パッケージが見つかりません」というコンパイルエラーの原因と具体的な解決策について解説しました。

• 要点1: Javaのパッケージは物理的なディレクトリ構造と一致させる必要があり、package com.example.util;と宣言されたクラスは、ソースルートのcom/example/util/パスに配置されるべきです。
• 要点2: コンパイル時 (javac) と実行時 (java) には、CLASSPATH（-cpオプション）を使って、コンパイル済みの.classファイルが格納されているディレクトリのパッケージルートを指定することが不可欠です。
• 要点3: javac -dオプションを使って、ソースコードとコンパイル済みクラスファイルを分離し、パッケージ構造を自動生成させる方法が推奨されます。

この記事を通して、JavaのパッケージとCLASSPATHの役割が明確になり、この一般的なコンパイルエラーを自力で解決するスキルを身につけられたことでしょう。今後、より複雑なJavaプロジェクトを扱う際にも、この知識が大きな助けとなるはずです。

今後は、MavenやGradleといったビルドツールを利用して、プロジェクトのCLASSPATH管理や依存関係解決を自動化する方法についても記事にする予定です。

参考資料

• Oracle Javaドキュメント: Packages
• Oracle Javaドキュメント: javac - Java プログラミング言語コンパイラ
• Oracle Javaドキュメント: java - Java アプリケーション起動ツール