Java Hello World 入门教程：从 JDK 安装到编译运行第一个程序

Java Hello World：零基础编写、编译、运行第一个程序

准备好开启 Java 之旅了吗？本教程手把手带你完成 JDK 安装验证、源码编写、编译执行、常见报错排查，并推荐进阶学习路径。

JDK (Java Development Kit)：包含编译器 javac、运行时 java、工具链。官网下载 (推荐 LTS 版本 17/21) 或使用 Eclipse Temurin、Azul Zulu 等免费 OpenJDK 发行版。详细安装参考 JDK 安装指南。
文本编辑器：初学推荐 VS Code (安装 Extension Pack for Java) 或 Notepad++；进阶可用 IntelliJ IDEA Community、Eclipse。本教程演示用系统自带记事本，零依赖。

开始菜单 → Windows 附件 → 记事本

复制以下代码到记事本：

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

Win+R → cmd → 回车
cd C:\workspace

javac HelloWorld.java

成功时无任何输出，目录下生成 HelloWorld.class 字节码文件。

java HelloWorld

注意：运行时写类名 (不含 .class 后缀)，区分大小写。

Hello, World!

元素	说明
`public class HelloWorld`	公共类，文件名必须同名，一个文件仅能有一个 public 类
`public static void main(String[] args)`	程序入口：public 供 JVM 调用、static 无需实例化、void 无返回、String[] args 接收命令行参数
`System.out.println()`	标准输出流打印并换行，`System.out` 为 `PrintStream` 实例
`javac`	编译器，将 .java → .class 字节码
`java`	启动器，加载类、初始化 JVM、调用 main 方法

错误信息	原因	解决
`error: class HelloWorld is public, should be declared in a file named HelloWorld.java`	文件名与 public 类名不一致	重命名文件为 `HelloWorld.java`
`Error: Could not find or load main class HelloWorld`	类名拼写错误/未编译/包名不匹配/当前目录不在 classpath	确认 `HelloWorld.class` 存在；用 `java -cp . HelloWorld` 指定类路径
`javac: command not found` / `'javac' 不是内部命令`	JDK 未安装或 Path 未配置 `%JAVA_HOME%\bin`	重装 JDK、配置环境变量、重开终端
`error: unmappable character for encoding GBK`	源文件 UTF-8 但编译器默认 GBK (中文 Windows)	`javac -encoding UTF-8 HelloWorld.java` 或文件保存为 GBK
`Unsupported class file major version XX`	用低版本 java 运行高版本 javac 编译的 class	统一 JDK 版本，或 `javac --release 17` 指定目标版本

// 以下均为不同标识符
HelloWorld
helloworld
HELLOWorld
helloWorld  // 驼峰命名规范

铁律：Java 严格区分大小写，类名 PascalCase、方法/变量 camelCase、常量 UPPER_SNAKE_CASE。

C:\workspace
└── com
    └── example
        └── helloworld
            ├── HelloWorld.java
            └── HelloWorld.class (编译后)

编译运行：

cd C:\workspace
javac com/example/helloworld/HelloWorld.java
java com.example.helloworld.HelloWorld