概述

Java 程序文件之间的组织方式是通过 包（Package）、类（Class） 和 目录结构来进行组织的。

1. 目录结构和包对应。
2. 一个 .java 文件中 通常只定义一个公有类（public class），且文件名必须与该类名保持一致。

类与文件的关系

文件后缀：Java 源代码文件必须以 .java 作为文件扩展名。
编码格式：Java 源文件通常使用 UTF-8 编码。
文件名与类名一致：

• 一个 .java 文件中 通常只定义一个公有类（public class）或接口，且文件名必须与该类名一致（包括大小写）。
• tips：可以在同一个文件中定义多个非 public 类，但最好每个类一个文件，方便维护。

下面是一个最简单的可运行程序，只有一个执行函数，没有字段。

//Main.java：
public class Main 
{ 
   public static void main(String[] args)
   { System.out.println("Hello, World!"); } 
}

下面是复杂一点的，基本上带齐了JAVA要素，包、类、成员变量、构造方法、成员方法、主方法。

//MyClass.java
// 包声明（如果有）
package com.example.myapp;

// 导入语句
import java.util.List;
import java.util.ArrayList;

// 类/接口声明
public class MyClass {
    // 成员变量（字段）
    private String name;

    // 构造方法
    public MyClass(String name) {
        this.name = name;
    }

    // 方法
    public void sayHello() {
        System.out.println("Hello, " + name);
    }

    // 主方法（如果需要）
    public static void main(String[] args) {
        MyClass obj = new MyClass("World");
        obj.sayHello();
    }
}

包（Package）

包是 Java 中组织类的一种机制，类似于文件夹，可以防止类名冲突并提供更清晰的结构。
包声明必须放在 Java 文件的第一行（注释和空行除外），使用 package 关键字声明：

package com.example.myapp; //表示该类属于 com.example.myapp 包。

包名一般使用 公司域名的反写 + 项目名 + 模块名 作为结构，例如：com.company.project.module

目录结构

Java 要求源文件的物理路径必须与包名保持一致。
例如：

src/
I── com/
    └── example/
        └── myapp/
           ├── Main.java
           └── Utils.java

Main.java 和 Utils.java 的第一行应为：package com.example.myapp

命名与编码规范

类名：使用驼峰命名法，首字母大写，如 MyClass。
包名：全小写，通常为反向域名，如 com.example.myapp。
文件组织规范：

• 每个类尽量放在单独的 .java 文件中。
• 避免过多的类嵌套（尽量少用内部类）。
• 使用有意义的包名和类名，反映代码的功能。

代码格式：遵循一致的缩进（通常 4 个空格）、换行和括号风格，推荐使用工具（如 IntelliJ IDEA、Eclipse）自动格式化代码。