Java 开发环境搭建全攻略从 JDK 安装到 HelloWorld 运行前言Java 作为一门经典的编程语言至今依然是企业级开发的主力。无论你是刚接触编程的新手还是想重温基础的开发者搭建一个正确的 Java 开发环境都是第一步。本文将从零开始手把手带你完成JDK 安装 → 环境变量配置 → VS Code IDE 配置 → 编写并运行第一个 Java 程序的全流程。一、JDK 安装推荐 JDK 17 LTS 版本1.1 为什么选择 JDK 17JDK 17 是 Oracle 官方发布的长期支持版本LTS具有以下优势长期支持至少 8 年的安全更新生产环境首选性能提升相比 JDK 8/11 有显著的 GC 和 JIT 优化新特性丰富密封类、记录类、模式匹配等现代语言特性生态成熟Spring Boot 3.x、Jakarta EE 10 等主流框架已全面支持1.2 下载 JDK推荐使用Eclipse TemurinAdoptium发行版这是完全开源、免费的 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.1910或用户目录下无需管理员权限%LOCALAPPDATA%\Programs\Java\jdk-17.0.1910解压后的目录结构如下jdk-17.0.1910/ ├── 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.1910 (build 17.0.1910) OpenJDK 64-Bit Server VM Temurin-17.0.1910 (build 17.0.1910, mixed mode, sharing)二、环境变量配置JAVA_HOME 与 PATH安装好 JDK 后还需要配置环境变量才能在任意目录下使用java和javac命令。2.1 设置 JAVA_HOMEJAVA_HOME是一个指向 JDK 安装目录的环境变量许多 Java 工具如 Maven、Gradle、Tomcat都依赖它。通过 PowerShell 设置用户级无需管理员权限[Environment]::SetEnvironmentVariable(JAVA_HOME,D:\你的安装路径\jdk-17.0.1910,User)通过图形界面设置按Win I打开设置 → 搜索环境变量 → 点击编辑系统环境变量点击环境变量按钮在用户变量区域点击新建变量名JAVA_HOME变量值D:\你的安装路径\jdk-17.0.19102.2 配置 PATH将 JDK 的bin目录添加到PATH中这样系统就能在任意位置找到java和javac命令。通过 PowerShell 设置$currentPath[Environment]::GetEnvironmentVariable(Path,User)$javaBin%JAVA_HOME%\binif($currentPath-notlike*$javaBin*){$newPath$currentPath.TrimEnd(;);$javaBin[Environment]::SetEnvironmentVariable(Path,$newPath,User)Write-OutputPATH 已更新}通过图形界面设置在环境变量窗口的用户变量中找到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.1910 (build 17.0.1910) OpenJDK 64-Bit Server VM Temurin-17.0.1910 (build 17.0.1910, mixed mode, sharing) javac 17.0.19 D:\...\jdk-17.0.1910⚠️注意必须重新打开终端窗口旧窗口不会感知到环境变量的变化。三、IDE 选择VS Code3.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 JavaMaven 项目管理Project Manager for Java项目管理IntelliCodeAI 智能提示四、第一个 Java 程序HelloWorld4.1 创建源文件在项目目录下新建文件HelloWorld.javapublicclassHelloWorld{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.19104.5 编译运行流程图HelloWorld.java ──javac 编译──▶ HelloWorld.class ──java 运行──▶ 控制台输出 (源代码) (字节码) Hello, World!五、常见问题Q1javac命令找不到原因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:MetaspaceSize32m-XX:MaxMetaspaceSize128m-Xmx128mHelloWorldQ4java能运行但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 LTSOS: Windows 11IDE: Visual Studio Code Java Extension Pack编辑日期: 2026-07-01