Java 开发环境搭建全攻略：从 JDK 安装到 HelloWorld 运行

Java 开发环境搭建全攻略：从 JDK 安装到 HelloWorld 运行

前言

Java 作为一门经典的编程语言，至今依然是企业级开发的主力。无论你是刚接触编程的新手，还是想重温基础的开发者，搭建一个正确的 Java 开发环境都是第一步。本文将从零开始，手把手带你完成 JDK 安装 → 环境变量配置 → VS Code IDE 配置 → 编写并运行第一个 Java 程序 的全流程。

一、JDK 安装（推荐 JDK 17+ LTS 版本）

1.1 为什么选择 JDK 17？

JDK 17 是 Oracle 官方发布的长期支持版本（LTS），具有以下优势：

长期支持：至少 8 年的安全更新，生产环境首选
性能提升：相比 JDK 8/11 有显著的 GC 和 JIT 优化
新特性丰富：密封类、记录类、模式匹配等现代语言特性
生态成熟：Spring Boot 3.x、Jakarta EE 10 等主流框架已全面支持

1.2 下载 JDK

推荐使用 Eclipse Temurin（Adoptium） 发行版，这是完全开源、免费的 OpenJDK 发行版。

官方下载地址：https://adoptium.net/

国内镜像（推荐，下载速度快）：清华大学 TUNA 镜像站

复制代码

https://mirrors.tuna.tsinghua.edu.cn/Adoptium/17/jdk/x64/windows/

选择 OpenJDK17U-jdk_x64_windows_hotspot_17.0.19_10.zip 下载即可。

💡 Tips ：如果你的系统是 ARM 架构，请选择 aarch64 版本；大多数 Windows 用户选择 x64 即可。

1.3 安装 JDK（免安装版）

下载完成后，将 zip 包解压到一个固定目录，例如：

C:\Program Files\Java\jdk-17.0.19+10

或用户目录下（无需管理员权限）：

复制代码

%LOCALAPPDATA%\Programs\Java\jdk-17.0.19+10

解压后的目录结构如下：

jdk-17.0.19+10/
├── bin/ # 可执行文件（java, javac 等）
├── conf/ # 配置文件
├── include/ # C 语言头文件
├── jmods/ # 模块文件
├── legal/ # 法律声明
└── release # 版本信息
验证安装 --- 打开终端，进入 bin 目录执行：

powershell 复制代码

.\java.exe -version

输出如下表示安装成功：

复制代码

openjdk version "17.0.19" 2026-04-21
OpenJDK Runtime Environment Temurin-17.0.19+10 (build 17.0.19+10)
OpenJDK 64-Bit Server VM Temurin-17.0.19+10 (build 17.0.19+10, mixed mode, sharing)

二、环境变量配置（JAVA_HOME 与 PATH）

安装好 JDK 后，还需要配置环境变量，才能在任意目录下使用 java 和 javac 命令。

2.1 设置 JAVA_HOME

JAVA_HOME 是一个指向 JDK 安装目录的环境变量，许多 Java 工具（如 Maven、Gradle、Tomcat）都依赖它。

通过 PowerShell 设置（用户级，无需管理员权限）：

powershell 复制代码

[Environment]::SetEnvironmentVariable("JAVA_HOME", "D:\你的安装路径\jdk-17.0.19+10", "User")

通过图形界面设置：

按 Win + I 打开设置 → 搜索"环境变量" → 点击"编辑系统环境变量"
点击"环境变量"按钮
在"用户变量"区域点击"新建"
变量名：JAVA_HOME
变量值：D:\你的安装路径\jdk-17.0.19+10

2.2 配置 PATH

将 JDK 的 bin 目录添加到 PATH 中，这样系统就能在任意位置找到 java 和 javac 命令。

通过 PowerShell 设置：

powershell 复制代码

$currentPath = [Environment]::GetEnvironmentVariable("Path", "User")
$javaBin = "%JAVA_HOME%\bin"
if ($currentPath -notlike "*$javaBin*") {
    $newPath = $currentPath.TrimEnd(';') + ";" + $javaBin
    [Environment]::SetEnvironmentVariable("Path", $newPath, "User")
    Write-Output "PATH 已更新"
}

通过图形界面设置：

在"环境变量"窗口的"用户变量"中找到 Path
点击"编辑" → "新建"
输入 %JAVA_HOME%\bin
确定保存

2.3 验证环境变量

关闭所有终端窗口，重新打开一个新的 PowerShell（这很重要，环境变量需要新窗口才生效），执行：

powershell 复制代码

java -version
javac -version
echo $env:JAVA_HOME

输出如下表示配置成功：

复制代码

openjdk version "17.0.19" 2026-04-21
OpenJDK Runtime Environment Temurin-17.0.19+10 (build 17.0.19+10)
OpenJDK 64-Bit Server VM Temurin-17.0.19+10 (build 17.0.19+10, mixed mode, sharing)

javac 17.0.19

D:\...\jdk-17.0.19+10

⚠️ 注意：必须重新打开终端窗口，旧窗口不会感知到环境变量的变化。

三、IDE 选择：VS Code

3.1 为什么选择 VS Code？

轻量级：启动快，占用资源少
插件生态丰富：Java Extension Pack 提供完整的 Java 开发支持
免费开源：无需付费授权
多语言支持：一个编辑器搞定所有编程语言

3.2 安装 VS Code

官方下载地址：https://code.visualstudio.com/

下载后按默认选项安装即可。

3.3 安装 Java 扩展包

打开 VS Code
按 Ctrl + Shift + X 打开扩展面板
搜索 Java Extension Pack
点击安装

或通过命令行安装：

powershell 复制代码

code --install-extension vscjava.vscode-java-pack

Java Extension Pack 包含以下组件：

扩展	功能
Language Support for Java	语法高亮、代码补全
Debugger for Java	断点调试
Java Test Runner	单元测试
Maven for Java	Maven 项目管理
Project Manager for Java	项目管理
IntelliCode	AI 智能提示

四、第一个 Java 程序：HelloWorld

4.1 创建源文件

在项目目录下新建文件 HelloWorld.java：

java 复制代码

public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello, World!");
        System.out.println("Java 环境搭建成功！");
        System.out.println("JDK 版本: " + System.getProperty("java.version"));
        System.out.println("JAVA_HOME: " + System.getProperty("java.home"));
    }
}

⚠️ 注意：文件名必须与 public class 后的类名完全一致（区分大小写），即 HelloWorld.java。

4.2 Java 程序结构详解

java 复制代码

public class HelloWorld {                  // 类声明，public 表示公开访问
    public static void main(String[] args) {  // 主方法，程序入口
        System.out.println("Hello, World!");  // 输出语句
    }
}

关键字	含义
`public`	访问修饰符，表示公开可见
`class`	声明一个类
`static`	静态方法，无需创建对象即可调用
`void`	无返回值
`main`	主方法名，JVM 固定入口
`String[] args`	命令行参数数组

4.3 编译

打开终端，进入源文件所在目录，执行编译命令：

bash 复制代码

javac -encoding UTF-8 HelloWorld.java

⚠️ 编码问题 ：Windows 系统默认使用 GBK 编码，如果源文件包含中文，需要加 -encoding UTF-8 参数，否则会报错：
复制代码
HelloWorld.java:4: 错误: 编码 GBK 的不可映射字符

编译成功后，目录下会生成 HelloWorld.class 字节码文件：

复制代码

HelloWorld.java    ← 源文件
HelloWorld.class   ← 编译生成的字节码

4.4 运行

执行以下命令运行程序：

bash 复制代码

java HelloWorld

输出结果：

复制代码

Hello, World!
Java 环境搭建成功！
JDK 版本: 17.0.19
JAVA_HOME: D:\...\jdk-17.0.19+10

4.5 编译运行流程图

复制代码

HelloWorld.java  ──javac 编译──▶  HelloWorld.class  ──java 运行──▶  控制台输出
   (源代码)                        (字节码)                    "Hello, World!"

五、常见问题

Q1：`javac` 命令找不到？

原因：PATH 环境变量未正确配置。

解决：

确认 JAVA_HOME 已正确设置
确认 PATH 中包含 %JAVA_HOME%\bin
重新打开终端窗口

Q2：编译时报编码错误？

原因：Windows 默认 GBK 编码，与 UTF-8 源文件冲突。

解决：编译时加 -encoding UTF-8 参数

bash 复制代码

javac -encoding UTF-8 HelloWorld.java

Q3：运行时报内存不足？

原因：在某些受限环境中，JVM 默认内存参数可能过大。

解决：限制 JVM 内存

bash 复制代码

java -Xshare:off -XX:MetaspaceSize=32m -XX:MaxMetaspaceSize=128m -Xmx128m HelloWorld

Q4：`java` 能运行但 `javac` 找不到？

原因：系统中可能预装了 JRE（只有 java，没有 javac）。

解决：确认 PATH 中 JDK 的 bin 目录排在 JRE 前面，或删除旧的 JRE 配置。

六、总结

本文完整介绍了 Java 开发环境的搭建流程：

步骤	内容	状态
1	下载安装 JDK 17 LTS	✅
2	配置 JAVA_HOME 和 PATH 环境变量	✅
3	安装 VS Code 及 Java 扩展包	✅
4	编写 HelloWorld.java 源文件	✅
5	使用 javac 编译、java 运行	✅

核心命令回顾：

bash 复制代码

# 编译
javac -encoding UTF-8 HelloWorld.java

# 运行
java HelloWorld

环境搭建好之后，就可以开始你的 Java 编程之旅了！下一篇我们将学习 Java 的基本语法和数据类型，敬请期待。

📌 本文环境信息：

JDK: Eclipse Temurin 17.0.19 LTS

OS: Windows 11

IDE: Visual Studio Code + Java Extension Pack

编辑日期: 2026-07-01

Java 开发环境搭建全攻略：从 JDK 安装到 HelloWorld 运行