Java源文件必须满足:最多一个public类且文件名严格匹配;package声明须在最顶部;import紧随其后;可含多个非public顶层类。

Java 源文件必须遵循严格的结构规则,否则编译器会报错。核心原则是:一个源文件中最多只能有一个 public 类,且该类名必须与文件名完全一致(包括大小写),文件扩展名必须为 .java。
文件名与 public 类名必须严格匹配
如果定义了 public 类,则源文件名必须与该类名完全相同。例如:
- 声明
public class Calculator { ... }→ 文件必须命名为Calculator.java - 若命名为
calculator.java或Calc.java,编译时会提示class Calculator is public, should be declared in a file named Calculator.java - 没有 public 类时,文件名可任意(但仍需以 .java 结尾),但此时不能通过 javac 直接编译该文件来生成可运行的入口(除非含 main 方法且不依赖 public 修饰)
package 声明必须位于最顶部(若有)
如果源文件属于某个包,package 语句必须是文件中第一个非注释、非空行:
- 正确位置:
package com.example.util;→ 紧贴文件开头,前面不能有 import 或类定义 - 错误示例:在 package 前加注释以外的内容(如 import、类、空行)会导致编译失败
- 一个文件最多一个 package 声明;未声明 package 的类默认属于“无名包”,不推荐用于工程化项目
import 语句紧随 package(若有),位于类定义之前
import 用于引入其他包中的类或静态成员,需满足顺序要求:
立即学习“Java免费学习笔记(深入)”;
- 若存在 package,import 必须在 package 之后、类定义之前
- import 不区分顺序(编译器不校验先后),但习惯上按标准库(java.*)、扩展库(javax.*)、第三方、自定义包分组排列
- 可使用通配符(如
import java.util.*;),但不建议滥用,易引发命名冲突且降低可读性
类定义是文件主体,顺序和可见性有约束
一个 Java 源文件可包含多个类(含内部类),但有明确限制:
- 最多一个 public 类(且已由文件名绑定)
- 可包含任意数量的 package-private 类(即不加访问修饰符,默认仅本包可见)
- 可包含 private、protected 或 static 内部类(写在其他类内部)
- 顶层类(非内部类)不能用 private 或 protected 修饰(编译报错)










