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目录执行：
.\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 设置（用户级，无需管理员权限）：
[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 设置：
$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（这很重要，环境变量需要新窗口才生效），执行：
java-version javac-versionecho$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 - 点击安装
或通过命令行安装：
code--install-extensionvscjava.vscode-java-packJava 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：
publicclassHelloWorld{publicstaticvoidmain(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 程序结构详解
publicclassHelloWorld{// 类声明，public 表示公开访问publicstaticvoidmain(String[]args){// 主方法，程序入口System.out.println("Hello, World!");// 输出语句}}| 关键字 | 含义 |
|---|---|
public | 访问修饰符，表示公开可见 |
class | 声明一个类 |
static | 静态方法，无需创建对象即可调用 |
void | 无返回值 |
main | 主方法名，JVM 固定入口 |
String[] args | 命令行参数数组 |
4.3 编译
打开终端，进入源文件所在目录，执行编译命令：
javac-encodingUTF-8 HelloWorld.java⚠️编码问题：Windows 系统默认使用 GBK 编码，如果源文件包含中文，需要加
-encoding UTF-8参数，否则会报错：HelloWorld.java:4: 错误: 编码 GBK 的不可映射字符
编译成功后，目录下会生成HelloWorld.class字节码文件：
HelloWorld.java ← 源文件 HelloWorld.class ← 编译生成的字节码4.4 运行
执行以下命令运行程序：
javaHelloWorld输出结果：
Hello, World! Java 环境搭建成功！ JDK 版本: 17.0.19 JAVA_HOME: D:\...\jdk-17.0.19+104.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参数
javac-encodingUTF-8 HelloWorld.javaQ3：运行时报内存不足？
原因：在某些受限环境中，JVM 默认内存参数可能过大。
解决：限制 JVM 内存
java-Xshare:off-XX:MetaspaceSize=32m-XX:MaxMetaspaceSize=128m-Xmx128mHelloWorldQ4：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 运行 | ✅ |
核心命令回顾：
# 编译javac-encodingUTF-8 HelloWorld.java# 运行javaHelloWorld环境搭建好之后，就可以开始你的 Java 编程之旅了！下一篇我们将学习 Java 的基本语法和数据类型，敬请期待。
📌本文环境信息：
- JDK: Eclipse Temurin 17.0.19 LTS
- OS: Windows 11
- IDE: Visual Studio Code + Java Extension Pack
- 编辑日期: 2026-07-01
