Java源文件命名为何必须严格遵循与public类名一致的规则？

本文共计963个文字，预计阅读时间需要4分钟。

Java 编译器依赖文件名定位 public 类，这不是风格建议，而是强制解析规则。违反此规则将导致编译失败，没有剩余的商用地。

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

Java 编译器（javac）在读取源文件时，并不先解析整个文件内容再找 public class；它直接用文件名推断“这个文件里应该声明了哪个 public 类”。比如你运行 javac Server.java，编译器就认定：此文件中必须且只能有一个 public class Server，否则拒绝工作。

• 这不是为了“代码整洁”，而是类加载机制的底层依赖：JVM 通过全限定名（如 com.example.Server）查找 .class 文件，而该路径由包声明 + 文件名共同决定
• IDE 和构建工具（如 Maven）也按此规则扫描源码；文件名错位会导致类无法被识别、测试类找不到目标、模块编译中断
• 大小写敏感是硬性要求：Server.java 里写 public class server 会报错，错误信息通常是：class server is public, should be declared in a file named server.java

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

你可以把 public class ApiClient 和几个 class RequestDto、class ResponseWrapper 全塞进 ApiClient.java 里——只要 ApiClient 是唯一的 public 类，其他类用默认访问权限（即不加修饰符）即可。

• 非 public 类可以任意命名，也不必与文件名相同
• 但不能有两个 public 类：public class A 和 public class B 同时出现在一个文件里，编译器会报 class A is public, should be declared in a file named A.java（或类似提示）
• 如果文件里一个 public 类都没有，那文件名就完全自由，比如叫 Utils.java 或 temp.java 都行（但没人这么干，维护起来太痛苦）

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

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

立即学习“Java免费学习笔记（深入）”；

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

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