如何理解 Java 源文件命名必须与 public 类名一致的语法规定

Ja va 编译器在编译源文件时，有一个看似“死板”的规则：源文件名必须与 public 类的类名完全一致。这不是什么风格建议，而是硬性强制——文件名写错一个字，编译就直接报错，没有任何商量的余地。

说白了，你写一个 Server.ja va，编译器就认为里面只能放一个 public class Server；如果你非要放个 public class server（大小写不一样），它也会翻脸。那这个规则背后的逻辑是什么？我们来拆开看看。

为什么编译器死磕文件名和 public 类名必须一致

Ja va 编译器（ja vac）的处理流程非常直接：它拿到文件名后，不会先把整个文件解析一遍再去找哪个类是 public 的，而是反过来——用文件名推断出“这个文件里应该声明了哪个 public 类”。比如你执行 ja vac Server.ja va，编译器就默认：这个文件里必须且只能有一个 public class Server，否则就拒绝干活。

• 这绝不仅仅是“代码整洁”层面的约束，而是整个类加载机制的基础：JVM 通过全限定名（如 com.example.Server）来查找 .class 文件，而这个全限定名由包声明 + 文件名共同决定。
• IDE 和构建工具（Ma ven、Gradle 等）也全按这个规则扫描源码；文件名对不上，类就无法被识别，测试类找不到目标，模块编译直接中断。
• 大小写敏感是硬性红线：Server.ja va 里写 public class server，报错信息通常是 class server is public, should be declared in a file named server.ja va——非常直白。

一个文件里有多个类，只有 public 类受命名约束

那是不是说一个文件里只能有一个类？当然不是。你可以把 public class ApiClient 和几个辅助类（比如 class RequestDto、class ResponseWrapper）全塞进 ApiClient.ja va 里。只要 ApiClient 是唯一的 public 类，其他类用默认访问权限（即不加任何修饰符）即可。

• 非 public 的类可以任意命名，完全不受文件名限制。
• 但注意：一个文件里绝对不能出现两个 public 类。如果你写了 public class A 和 public class B，编译器会报 class A is public, should be declared in a file named A.ja va（或类似的提示）。
• 如果文件里一个 public 类都没有，那文件名就完全自由，比如叫 Utils.ja va 甚至 temp.ja va 都行——但实际项目中没人这么干，因为维护起来太痛苦，你根本不知道这个文件里到底有哪些类。

常见错误现象和快速自查点

碰到编译失败，先盯住三件事：

• 文件名是否带了空格或中文？比如 My Class.ja va 或 用户管理.ja va —— 这些连基本文件合法性都不满足。
• 文件名是否多写了后缀？比如系统可能隐藏了扩展名，但你保存成了 Server.ja va.ja va，ja vac 看到的是两个 .ja va。
• 类声明前有没有意外的不可见字符？比如从网页复制代码时带入的零宽空格（U+200B），会导致 public class Server 实际变成 public class
Server，编译器根本认不出。
• 包声明是否和目录结构匹配？比如写了 package com.example;，那文件就必须放在 com/example/Server.ja va 路径下。否则即使类名和文件名都对得上，也会因路径不符导致类找不到。

真正容易被忽略的，是那个“默认访问权限类可任意命名”的自由度。很多人误以为所有类都必须跟文件同名，结果把辅助类也单独拆成文件，徒增管理成本。反过来，也有人偷偷在 Server.ja va 里加第二个 public class Config，以为只是多写一行，结果卡在编译第一步。记住：一个 public 类，一个文件名，匹配就对了。