できない.dev

Java「is public, should be declared in a file named」の原因と直し方

should be declared in a file named は、ファイル名を public クラス名に合わせれば直る。
1 つのファイルに public クラスを 2 つ書いても出るので、片方の public を外すか別のファイルに分ける。

公開: 更新:

症状できない · exit 1
javac -d out Hello.java
Hello.java:1: error: class HelloWorld is public, should be declared in a file named HelloWorld.java
public class HelloWorld {
       ^
1 error
解決後できた · exit 0
javac -d out HelloWorld.java

2026-11-19 に eclipse-temurin:17-jdk(Java 17.0.21) で実際に打って取った出力。検証環境の詳細

要約

javac でコンパイルすると、次のエラーで .class ができない。

Hello.java:1: error: class HelloWorld is public, should be declared in a file named HelloWorld.java
public class HelloWorld {
       ^
1 error

class HelloWorld is public, should be declared in a file named HelloWorld.java は、public なクラスの名前とファイル名が一致していないときのコンパイルエラーである。
ファイル名を public class の名前に合わせれば直る。
エラー文の末尾に、置くべきファイル名がそのまま出ている。

実行例

Hello.java に public class HelloWorld を書くと javac は終了コード 1 でエラーになり、ファイル名を HelloWorld.java に合わせると 0 で通る。
App.java に public クラスを 2 つ書いた場合も同じエラーになり、Util の public を外すと App.class と Util.class が出力される。

$ javac -d out Hello.java
Hello.java:1: error: class HelloWorld is public, should be declared in a file named HelloWorld.java
public class HelloWorld {
       ^
1 error
$ echo $?
1
$ mv Hello.java HelloWorld.java
$ javac -d out HelloWorld.java
$ echo $?
0
$ java -cp out HelloWorld
hello
$ javac -d out2 App.java
App.java:6: error: class Util is public, should be declared in a file named Util.java
public class Util {
       ^
1 error
$ echo $?
1
$ javac -d out2 App.java
$ echo $?
0
$ ls out2
App.class
Util.class

— 2026-11-19 時点の出力

検証環境Java 17.0.21 / 2026-11-19 検証
検証日
実行環境
eclipse-temurin:17-jdk Ubuntu 26.04.1 LTS
バージョン
  • Java 17.0.21

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. ファイル名をクラス名に合わせる

mv Hello.java HelloWorld.java
javac -d out HelloWorld.java
java -cp out HelloWorld

エラー文に出たファイル名へ変えると、コンパイルが通って hello が出力された。
クラス名のほうを変える場合も、ファイル名と大文字と小文字まで揃える。

2. public なクラスは 1 ファイルに 1 つにする

public class App {
    public static void main(String[] args) {
        System.out.println(new Util().name());
    }
}
 
class Util {
    String name() { return "util"; }
}

同じパッケージの中だけで使うクラスなら、public を外せば同じファイルに置ける。
javac 17.0.21 では、Util の public を外すとコンパイルが通り、App.class と Util.class の 2 つができた。
別のパッケージから使うクラスは、Util.java に分けて public のままにする。

よくある原因

  1. ファイル名とクラス名が違う。
    javac は、public なクラスを「クラス名 + .java」の名前のファイルに置くことを求める(Java 言語仕様 7.6(新しいタブで開く))。
    eclipse-temurin:21-jdk の javac 21.0.13 で、Hello.java に public class HelloWorld を書くと上のエラーになり、終了コードは 1 だった。
  2. 大文字と小文字が違う。
    HelloWorld.java に public class helloworld と書くと、should be declared in a file named helloworld.java と出る。
    名前の比較は大文字と小文字を区別する。
  3. public なクラスを 1 つのファイルに 2 つ書いている。
    javac では、1 つのファイルに置ける public なトップレベルのクラスは 1 つまでである。
    eclipse-temurin:17-jdk の javac 17.0.21 で App.java に public class App と public class Util を書くと、class Util is public, should be declared in a file named Util.java になった。

java Hello.java のようにソースファイルを直接実行する形では、このエラーは出ない(JEP 330(新しいタブで開く))。
1 の Hello.java も java Hello.java では hello と出力された。
java Hello.java で動いていたファイルも、javac でコンパイルすると落ちる。