Java程序代码必须写在类（class）中，不能直接写裸语句；所有代码包括main方法都需属于某个类，且public类名须与.java文件名完全一致。

Java 需要 class，意思是：Java 程序的代码必须写在类（class）里面，不能像 Python 或 JavaScript 那样直接写裸语句。

比如，你不能这样写：

// ❌ 错误！Java 不允许这样
System.out.println("Hello");
int x = 10;

而必须包在一个 class 里：

// ✅ 正确！所有代码都在 class 内部
public class Hello {
    public static void main(String[] args) {
        System.out.println("Hello");
        int x = 10;
    }
}

这是因为 Java 是一门纯粹的面向对象语言，设计上要求一切代码都属于某个类——哪怕是 main 方法（程序入口），也必须是某个类的静态成员。

注意：.java 源文件名必须和其中 public 类的名字完全一致（大小写敏感），例如 public class Hello → 文件必须叫 Hello.java。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

例外情况：一个 .java 文件里可以有多个 class，但最多只能有一个 public 类，且文件名必须匹配它。

为什么这样设计？

• 强制封装和结构化，避免代码散乱
• 支持面向对象特性（继承、多态、访问控制等）
• JVM 运行时以“类”为基本单位加载和执行代码

简单说：

• class 是 Java 的“代码容器”
• 没有 class，Java 就不认识你的代码
• 所有可执行逻辑（包括 main 方法）都得塞进某个 class 里

基本上就这些。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南