Java 程序基本结构

约 666 字大约 2 分钟

布欧-Lewyon

2026-05-14

本节说明一个可独立运行的 Java 源文件常见长什么样，以及包、导入、注释与命名上容易踩的坑。

类与源文件

若类声明为 public，源文件名必须与该类名一致（区分大小写），后缀 .java。
一个源文件可有多个类，但最多一个 public 类；初学阶段保持一个 public 类即可。

`main` 方法

Java 程序的入口是一个签名为 public static void main(String[]) 的静态方法。JVM 启动时会查找这个签名并调用它——方法名 main 是约定，参数 args 接收命令行参数。省略任何修饰符（public、static）或返回类型非 void 都会导致 JVM 找不到入口。

以下是最小可运行程序的完整写法。重点关注签名中各关键字的作用（public 让 JVM 能访问、static 无需实例化对象即可调用、void 表示不返回值）：

public class Hello {
    public static void main(String[] args) {
        System.out.println("Hello");
    }
}

args 接收命令行参数，无参时为空数组，不要写成 null。

包与导入

package 声明源文件所属命名空间，应放在文件第一行（注释与空行可在此之前，习惯上 package 仍置顶）。
目录结构需与包名对应：如 package com.example.demo; 则路径一般为 com/example/demo/Hello.java。
import 引入其他类型的短名；同包内类型无需导入。java.lang.* 下的类型默认可见，无需写 import。

注释

单行：//
多行：/* ... */
文档注释：/** ... */，可由 javadoc 生成 API 文档，公共 API 上建议写清参数与返回值含义。

命名习惯（简）

类、接口：UpperCamelCase。
方法、字段、局部变量：lowerCamelCase。
常量：ALL_CAPS_WITH_UNDERSCORES。

与团队或项目规范冲突时，以项目为准。

小结

核心结构：一个 .java 文件最多一个 public 类，类名必须与文件名一致。
main 签名：public static void main(String[]) — public、static、void 缺一不可。
包与目录对应：package com.example; 的源文件应放在 com/example/ 目录下。
注释有三种：// 单行、/* */ 多行、/** */ 文档注释（可生成 API 文档）。
易错：main 方法的 args 在没有命令行参数时是空数组而非 null，用 args.length 判断即可，不要写 if (args == null)。
思考任务：按本节结构新建一个 HelloWorld.java，用 javac 编译后用 java 运行，尝试传入命令行参数并在 main 中打印 args[0]。

上一节：开发环境与工具链

下一节：基本类型与运算

Java 程序基本结构

类与源文件

main 方法

包与导入

注释

命名习惯（简）

小结

`main` 方法