Java编译器强制要求public类名与文件名严格一致，因编译时直接通过文件名推断public类名称，否则报错；一个文件至多一个public类，非public类命名自由，无public类时文件名任意。
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 类，其他类用默认访问权限（即不加修饰符）即可。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 非
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都行（但没人这么干，维护起来太痛苦）
常见错误现象和快速自查点
遇到编译失败，先盯住三件事：
- 文件名是否带了空格或中文？例如
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，以为只是多写一行，结果卡在编译第一关。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
