【入门篇】一键搞定 Java 环境配置，从 0 跑出你的第一个程序

以下是针对零基础小白的完整、一步到位教程：从0到1配置好Java环境，并运行出你的第一个“Hello World”程序（基于2026年3月当前最新主流情况）。

当前（2026年3月）推荐选择：

• 最稳：JDK 21（上一个LTS，兼容性极好，企业仍在大量使用）
• 最新LTS：JDK 25（2025年9月发布的长期支持版）
• 尝鲜：JDK 26（2026年3月刚GA不久，包含最新特性）

小白强烈建议：先用 JDK 21 或 JDK 25（免费商用友好）。

步骤1：下载JDK（官网推荐方式）

官网统一入口（Oracle）：
https://www.oracle.com/java/technologies/downloads/

2026年3月主流选项：

• JDK 25（最新LTS） → 推荐大多数新手
• JDK 21（上一代LTS） → 最稳，教程最多
• JDK 17 → 仍然很多老项目用

国内用户加速方式（推荐，避免登录/慢速）：

• https://mirrors.tuna.tsinghua.edu.cn/Adoptium/ （Adoptium Temurin，开源免费）
• https://mirrors.huaweicloud.com/java/jdk/ 或 https://mirrors.aliyun.com/java/jdk/
• Azul Zulu、Amazon Corretto 也都是优秀免费选择

选择对应系统：

• Windows → x64 Installer (.msi 或 .exe)
• macOS → .pkg 或 .tar.gz
• Linux → .tar.gz 或用包管理器

下载后得到类似文件：

• jdk-21.0.4_windows-x64_bin.exe
• jdk-25.0.2_macos-x64_bin.pkg
• jdk-21_linux-x64_bin.tar.gz

步骤2：安装JDK（几乎傻瓜式）

Windows

1. 双击 .exe 或 .msi 文件
2. 点「下一步」 → 记住安装路径（默认通常是 C:\Program Files\Java\jdk-21...）
3. 安装完成 → 关闭

重要：记下你的JDK安装目录，例如：

C:\Program Files\Java\jdk-21.0.4

macOS

1. 双击 .pkg 文件
2. 一直「继续」 → 输入密码 → 安装完成
3. 默认路径通常是：/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home

Linux（以Ubuntu为例）

# 方式1：用包管理器（最简单，推荐）
sudo apt update
sudo apt install openjdk-21-jdk   # 或 openjdk-17-jdk / openjdk-25-jdk（如果有）

# 方式2：手动解压 tar.gz
tar -zxvf jdk-21_linux-x64_bin.tar.gz -C /usr/lib/jvm/
# 然后后面配置环境变量指向 /usr/lib/jvm/jdk-21...

步骤3：配置环境变量（最关键一步！）

Windows（最常见）

1. 右键「此电脑」→ 属性 → 高级系统设置 → 环境变量
2. 在系统变量里：

• 新建 → 变量名：JAVA_HOME
  变量值：你的JDK安装目录（例如 C:\Program Files\Java\jdk-21.0.4）
• 找到 Path → 编辑 → 新建 → 输入：
  %JAVA_HOME%\bin

1. 点确定全部关闭

macOS / Linux（zsh/bash通用）

打开终端，编辑配置文件：

# macOS 新系统基本都是 zsh
nano ~/.zshrc
# 或老系统 / Linux 常用 bash
nano ~/.bashrc

在文件末尾添加（替换成你实际路径）：

export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home
# Linux 示例：export JAVA_HOME=/usr/lib/jvm/jdk-21
export PATH=$JAVA_HOME/bin:$PATH

保存退出后，刷新生效：

source ~/.zshrc    # 或 source ~/.bashrc

步骤4：验证安装成功

任意位置打开命令行/终端，输入下面三条命令（每条都应该有输出）：

java -version
javac -version
echo %JAVA_HOME%    # Windows
# 或
echo $JAVA_HOME     # macOS/Linux

看到类似输出就成功：

openjdk version "21.0.4" 2024-07-16 LTS
OpenJDK Runtime Environment Temurin-21.0.4+7 (build 21.0.4+7-LTS)
OpenJDK 64-Bit Server VM Temurin-21.0.4+7 (build 21.0.4+7-LTS, mixed mode, sharing)
javac 21.0.4

步骤5：写出并运行第一个Java程序

1. 新建文件夹，例如 D:\java_test 或 ~/java_test
2. 在里面新建文本文件，命名为 HelloWorld.java（注意后缀必须是 .java） 内容复制下面代码（注意大小写！）：

public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello, Java! 欢迎来到Java世界～ 重阳加油！");
    }
}

3. 打开命令行/终端，cd 到这个文件夹

cd D:\java_test          # Windows
# 或
cd ~/java_test           # macOS/Linux

4. 编译 + 运行（两条命令）

javac HelloWorld.java     # 编译 → 生成 HelloWorld.class
java HelloWorld           # 运行（注意：类名不加 .class）

成功看到：

Hello, Java! 欢迎来到Java世界～ 重阳加油！

恭喜！你已经成功跑出了人生第一个Java程序！

快速排错清单（新手最常见10个问题）

现象	原因 & 解决
‘java’ 不是内部或外部命令	环境变量没配对 / Path 里没加 %JAVA_HOME%\bin
javac 命令找不到	同上，只配了 java 没配 javac（编译器）
提示 Unsupported class file	JDK版本太新/太旧 → 统一用 JDK 21 或 17
main 方法找不到	类名和文件名必须完全一致（包括大小写）
public class 必须和文件名一致	Java强制要求

最后建议（新手路线）

1. 先用命令行熟悉 1–2 周（理解编译、运行、classpath）
2. 然后安装 IntelliJ IDEA Community（免费）或 VS Code + Extension Pack for Java
3. IDEA里新建项目 → 直接运行 main 方法 → 告别命令行痛苦期

现在轮到你了！
把你运行成功后的截图或版本信息贴出来，我帮你确认是否完美配置～
或者告诉我你现在卡在哪一步了？（下载？安装？环境变量？运行报错？）我一步步陪你搞定。加油，重阳！你的Java第一步已经迈出去了！