Java下载安装教程：JDK版本选择与环境变量配置完整指南

Java下载安装教程：JDK版本选择与环境变量配置完整指南

发布时间：2026/9/15 6:55:12
Java下载安装教程：JDK版本选择与环境变量配置完整指南 做过Java开发的朋友都知道环境安装这一步看着简单真正动手的时候却能劝退不少人。标题里只写了“java下载安装教程”但结合大家在群里、评论区问得最多的问题这篇会把下载、安装、环境变量配置、版本选择到报错排查全部讲透。你可能是刚准备学Java的小白也可能是为了跑某个工具比如HMCL启动器、MyEclipse、Drozer被迫装环境这篇教程都适用。我会把每一步操作背后的原因也讲清楚不然你照着配完还是不知道自己在干什么。1. 安装前的三个关键认知1.1 JDK、JRE和JVM别再把它们混为一谈很多新手一上来就问“我该下载JDK还是JRE”这个问题说明对Java运行体系还不熟悉。我先用大白话解释一下JVM是Java虚拟机负责把编译后的class字节码翻译成当前操作系统能懂的机器指令JRE是Java运行时环境包含了JVM和一堆核心类库它让你能“运行”Java程序JDK是Java开发工具包包含了JRE的全部内容再加上javac编译器、jar打包工具、javadoc文档生成器等开发工具。打个比方JRE就像餐厅的后厨能把你点好的菜做出来端上桌JDK则在后厨基础上加了一套完整的“菜品研发设备”你不仅能做现成的菜还能研发新菜。装JDK会顺带把JRE装好但只装JRE的话连javac编译器都没有只能运行别人编译好的class文件干不了开发活。所以我每次给别人的建议都一样学Java或者做开发直接装JDK不用纠结单独装JRE。还有一个现实原因从JDK 9开始官方就不再提供独立的JRE安装包了。以后看到某些老教程让你专门去下载一个JRE可以直接关掉那是旧时代的配置方式。1.2 版本到底怎么选别一上来就装最新版Java的版本号这些年变得特别快每半年出一个新版本Oracle也改成了LTS长期支持和短期版本并行的发布节奏。这就导致一个问题下载页面一打开看到最新版本号就往上点结果装完之后发现项目跑不起来、工具不兼容只能卸了重装。这里我直接给结论。如果你是纯学习入门、跟着网课敲代码装Java 8也就是JDK 1.8或者Java 17都行但绝大多数老网课、老教程、还有学校老师给的示例代码都是基于Java 8写的。Java 8是最多企业仍在使用的版本它的稳定性和市场占有率摆在那里。如果你是在做新项目、测试Spring Boot 3或者较新的框架建议装Java 17或21这两个都是LTS版本支持周期长。至于最新的短期版本比如Java 22、23除非你有明确的技术需求否则别碰不值得在生产环境里当小白鼠。最稳妥的做法是电脑上同时装两个版本一个Java 8用于兼容老项目和上课学习一个Java 17用于新框架开发然后用环境变量去切换。后面我会讲具体怎么配。1.3 下载渠道官网最安全镜像站最省心Java的下载渠道是整个安装过程中最大的坑。搜索“java下载”能搜出一堆“高速下载”“破解版”“中文版”的网站很多都捆绑了全家桶软件甚至有些是带木马的。记住一个原则只从官方渠道下载。Oracle官网是下载Oracle JDK的正规渠道但有个小问题从Java 8u211开始Oracle JDK的下载需要登录Oracle账号还得勾选一大堆许可协议速度在国内也不算稳定。这里给大家几个靠谱的代替方案Adoptium也就是Eclipse Temurin这是最主流、口碑最好的OpenJDK发行版下载不需要登录页面清晰国内访问速度尚可。Amazon Corretto亚马逊维护的OpenJDK发行版长期免费稳定性很好。国内镜像站比如清华、阿里云的镜像虽然没有直接提供JDK二进制包但可以配合SDKMAN等工具间接使用。我自己日常的推荐顺序Adoptium Oracle Amazon Corretto。Adoptium的Temurin构建和Oracle JDK在功能上几乎没区别但下载体验好太多适合新手。2. Windows系统完整安装实操重点2.1 下载JDK并执行安装这一步有讲究以Windows平台为例我一步步演示。先打开浏览器进入Adoptium官网找到“Latest release”按钮页面会自动识别你的操作系统。如果你用的是64位Windows现在基本没有32位系统了如果没有特殊原因也别用选择Windows x64下的.msi或.zip格式我推荐.msi它是图形化安装向导不用手动解压。下载完成后双击运行安装界面会询问安装路径。这里有一个很多老手都踩过的坑安装路径不要出现中文、空格和特殊符号比如“D:\Java\jdk-17”可以“D:\软件\Java”这种就不推荐。原因是后续配置环境变量、IDE识别、构建工具解析路径时中文路径容易引起编码问题报错会很莫名其妙。安装过程中还有一个“Public JRE”的选项它不是必选而且要特别注意如果你勾选它它会把JRE装到另一个目录此时如果你同时装了多个JDK版本JRE的优先级反而会造成混乱。建议这个勾选去掉因为JDK里面已经带了JRE你不需要单独的公共JRE。2.2 环境变量配置JAVA_HOME、PATH、CLASSPATH三兄弟安装完成后最关键的一步就是配置环境变量。很多人卡在这儿不是配错了值而是根本没理解为什么要配。我先把原理讲明白。系统运行时当你敲下java命令操作系统会在当前目录和PATH变量中列出的所有路径里寻找java.exe。JDK的bin目录下就有java.exe和javac.exe所以你必须把bin目录加到PATH里系统才能找到这个命令。同理IDE和构建工具Maven、Gradle它们不直接找PATH而是去找JAVA_HOME这个变量以此确定你安装了哪套JDK、在哪个位置。所以JAVA_HOME就相当于一个通用的“指路牌”。正式开始操作按Win R打开运行框输入sysdm.cpl回车切换到“高级”选项卡点击“环境变量”。在“系统变量”区域点击“新建”变量名填写JAVA_HOME变量值填写你JDK的安装根路径比如D:\Java\jdk-17。注意不是填到bin目录是上一级根目录。接下来编辑Path变量在变量值的最前面添加%JAVA_HOME%\bin也可以用C:\Program Files\Eclipse Adoptium\jdk-17.0.10.7-hotspot\bin这种绝对路径但绝对路径有个致命缺陷以后你切换JDK版本或者移动目录必须手动改Path。用%JAVA_HOME%\bin这种相对引用以后只需改JAVA_HOME这一个变量就够了。至于CLASSPATH老教程会告诉你配成.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar这是完全过时的做法。从JDK 1.5开始编译器已经能自动搜索类文件根本不需要手动设置CLASSPATH。配错了反而可能引发奇怪的问题。我的建议别配CLASSPATH默认不设置才是现在的最佳实践。2.3 验证安装结果java和javac都要能跑配置完环境变量后关掉当前命令行窗口重新打开一个cmd窗口。为什么要重新打开因为环境变量修改后已有的进程不会刷新必须启动新进程才能拿到新的变量值。依次执行两个命令java -version javac -version如果配置成功你会分别看到类似这样的输出java version 17.0.10 2024-01-16 LTS Java(TM) SE Runtime Environment (build 17.0.1011) Java HotSpot(TM) 64-Bit Server VM (build 17.0.1011, mixed mode, sharing)javac 17.0.10如果你发现java -version有输出但javac -version报“不是内部或外部命令”多半是Path变量里的%JAVA_HOME%\bin没生效或者JAVA_HOME本身拼错了。还有一个常见情况java -version显示的版本和你安装的版本不一致那是你的Path里有多条Java相关路径Windows遇到同名命令时按Path顺序从前到后找先找到哪个就用哪个。这时候把%JAVA_HOME%\bin移到最前面即可。2.4 图文补充安装每个界面应该长什么样这里补充一下图文教程里通常会展示的截图内容。Adoptium的.msi安装包启动后首先出现的是Welcome界面直接点Next然后会进入“Custom Setup”界面这里默认是全部安装不需要改动再点是“Set JAVA_HOME variable”这个复选框默认是选中的保持选中否则安装完还要手动配JAVA_HOME最后路径那里记一下你选择的目标文件夹就行。Oracle官网的JDK安装包界面也类似但比Adoptium多了个登录账号的步骤。安装完成后建议顺手去“控制面板 - 系统和安全 - 系统 - 高级系统设置 - 环境变量”检查一下确认刚才记录下的路径有没有正确写入JAVA_HOME。3. macOS与Linux平台安装说明3.1 macOS两种方式推荐HomebrewmacOS用户装Java有两条路。第一条是到Adoptium下载macOS版本.pkg或.tar.gz正常双击安装默认安装路径是/Library/Java/JavaVirtualMachines/。第二条是如果你已经装了Homebrew一条命令搞定brew install --cask temurin装完之后在终端里检查一下/usr/libexec/java_home -V这个命令会列出系统里所有已安装的JDK版本并把它们的路径显示出来。macOS上配置环境变量要编辑~/.zshrc文件Catalina及以后版本默认用zsh老版本可能是~/.bash_profile。在文件末尾加export JAVA_HOME$(/usr/libexec/java_home -v 17) export PATH$JAVA_HOME/bin:$PATH保存后执行source ~/.zshrc让配置立即生效。这段配置里-v 17表示我当前需要使用Java 17如果以后装了多个版本想切换改这里的版本号就行。我建议macOS新手优先用Homebrew方式因为它管理JDK版本非常方便换版本不需要去翻目录找路径升级和回滚也简单。3.2 Linuxapt、yum和手动解压三种选择Linux服务器上跑Java项目很常见而且很多云服务器初始化配置时都会顺手装一个OpenJDK。Debian/Ubuntu系列用sudo apt update sudo apt install openjdk-17-jdkCentOS/RHEL/Fedora系列用sudo yum install java-17-openjdk-devel但这里有个问题系统软件源里的JDK版本往往比较旧。比如Ubuntu的默认源里OpenJDK可能还是13或者8想装最新LTS就得手动加PPA或者用SDKMAN。如果你要做企业级开发我比较推荐手动解压方式去Adoptium下载.tar.gz包解压到/usr/local/java/目录然后在/etc/profile或~/.bashrc里配置环境变量export JAVA_HOME/usr/local/java/jdk-17 export PATH$JAVA_HOME/bin:$PATH最后source /etc/profile生效。手动解压的好处是完全可控装哪个版本、放哪个路径都由你说了算不受系统软件源限制。还是在命令行里用java -version和javac -version验证一下是否生效。4. 环境变量配置深度解析与踩坑指南4.1 JAVA_HOME为什么是“万能指路牌”很多新手配置完环境变量后能正常跑Java了但没想过一个深层问题为什么Maven、Tomcat、Gradle这些工具不直接读Path非要单独读JAVA_HOME因为在大型项目中不同工具对JDK版本的要求可能不一样。Tomcat 9可以用Java 8跑但Maven编译时可能要求Java 11。如果没有JAVA_HOME这个统一入口每个工具都靠自己在Path里找那系统里有多个JDK时工具根本不知道该用哪个。通过JAVA_HOME所有生态工具都遵循同一个约定需要Java时先看JAVA_HOME指向哪里。所以你在配置JAVA_HOME时本质上就是在告诉这一整条工具链“用我指定的这套JDK”。这也是为什么我强调JAVA_HOME要填JDK根目录不要填什么jre目录也不要指向bin目录填错了工具链就会集体罢工。4.2 Path顺序之争为什么你的java版本总是不对版本不对的问题本质上是Path变量里存在多条Java路径。比如你装了JDK 17后又用安装包带了Oracle的Java 8残留那么原来的C:\Program Files (x86)\Common Files\Oracle\Java\javapath可能还在Path前头。系统执行java命令时从Path开头依次往后找找到第一个java.exe就停下来执行。所以不管Java 17装了多好只要Oracle的javapath排在前面你敲java -version看到的永远是旧版本。排查这个问题很简单。在cmd里执行where java它会显示出找到的每一个java.exe的完整路径路径列表的顺序就是系统查找的顺序。看到问题所在后去系统环境变量Path里把不需要的Java路径删掉把%JAVA_HOME%\bin移到最前面问题就能解决。顺带提醒一句Path里如果有多个同名目录且你自己不确定哪个在前哪个在后就一律用“编辑文本”模式看清楚不要在GUI里一个个挪那样效率太低了。4.3 为什么我不推荐用安装包自带的“Java路径自动配置”Windows安装.msi包时通常会勾选“设置JAVA_HOME”和“将bin加入Path”很多新手的习惯是看到勾选框就全选默认这也确实能用。但老手可能都不会太放心自动配置的效果。第一自动配置往往用的是绝对路径。以后你升级JDK或者把项目目录迁移到别的盘需要手动改这些旧路径如果忘了改工具链会全部指向旧的JDK就会出现“明明升级了JDK编译出来却是老版本行为”的诡异问题。第二有些安装包的自动配置会把JRE单独加进Path而JRE里没有javac这会导致javac命令不可用IDE里却正常排查起来很费劲。自己在环境变量里手动配置一遍虽然多花两分钟但整个路径结构完全在掌控之中以后出问题也能一眼看出哪里不对。4.4 用户变量和系统变量选哪个更好Windows环境变量分用户变量和系统变量。用户变量只对当前用户生效系统变量对所有用户生效。很多教程都让你配系统变量但对单机开发来说配置用户变量其实更安全、更好维护——你不想因为环境变量配错导致系统里其他本来正常的软件全部跟着遭殃。我的习惯是JAVA_HOME配到用户变量Path里在用户变量的变量值末尾加上%JAVA_HOME%\bin。这样切换版本只影响自己不会影响服务器上的其他账号。如果有特殊的多用户开发场景再考虑系统变量也不迟。5. 常见报错与排查技巧实录5.1 安装或验证阶段最常遇到的几个错误前面把正常安装流程讲完了但你实操过程中十有八九会遇到下面这几种情况。我做一个速查表按“现象-原因-解决方案”的方式拆开这样排查起来一目了然。报错现象常见原因解决方案java不是内部或外部命令Path里没加%JAVA_HOME%\bin或配置后没有重开cmd检查JAVA_HOME和Path重开命令行窗口javac不是内部或外部命令但java正常JRE单独存在或Path顺序问题确认JAVA_HOME指向JDK根目录不要指向JREjava版本和安装版本不一致Path里存在多个Java路径用where java排查删除无用路径将%JAVA_HOME%\bin前置编译通过但运行报ClassNotFoundException老教程引导配了错误的CLASSPATH清空CLASSPATH使用默认方式运行中文注释或中文输出显示乱码代码文件编码和编译器编码不一致统一UTF-8编码配置IDE和编译器的编码选项JDK安装后找不到JAVA_HOME自动设置msi安装时取消了勾选设置JAVA_HOME选项手动新建JAVA_HOME系统/用户变量5.2 MyEclipse报错java was started but returned exit code-1这是一个高频问题因为MyEclipse是比较老的IDE对新JDK版本支持不好。我看到有人还在用MyEclipse 2020却装了JDK 17甚至21启动时直接弹窗提示“Java was started but returned exit code-1”。这个错误的本质是IDE本身用你指定的JDK去启动JVM时初始化失败常见的坑有两个。第一个是JDK版本过高MyEclipse的启动器对高版本JDK的某些JVM参数不兼容。解决方法是给MyEclipse指定一个低版本JDK比如JDK 8在myeclipse.ini文件里加上-vm D:/Java/jdk-8/bin/javaw.exe注意-vm参数必须放在文件开头而且后面要换行写路径紧接着再写--launcher.appendVmargs相关参数否则不生效。第二个可能是电脑上默认的java.exe来自32位JDK但MyEclipse是64位的两者不匹配。这种情况下只需把环境变量里的JDK统一成64位版本即可。改完ini文件后如果还报错可以打开cmd手动执行一下java -version看看默认JDK能不能正常启动这一步能帮你迅速区分是IDE配置问题还是环境变量本身有问题。5.3 VS Code运行Java报错乱码编码问题一次说清用VS Code写Java的人越来越多因为它轻量、启动快。但它有个常见问题运行Java程序时控制台输出的中文乱码。这个问题的根源是编码不一致——你的源代码文件是UTF-8编码而Windows控制台默认可能是GBK编码运行时输出的字节流按GBK解析自然就是乱码。解决思路分两步。第一步让Java编译器使用UTF-8编码编译可以在settings.json里配置java.jdt.ls.vmargs: -Dfile.encodingUTF-8第二步让VS Code终端统一使用UTF-8。打开设置搜索terminal.integrated.profile.windows配置为默认使用UTF-8的终端或者在launch.json里给程序传入参数让程序输出时手动指定编码System.setOut(new PrintStream(System.out, true, UTF-8))。还需要提醒一个细节Windows的cmd窗口默认代码页是GBK或者中文系统下的936代码页即使你在Java代码里写了UTF-8输出控制台也未必能正确显示。一个简单办法是在cmd里执行chcp 65001切到UTF-8代码页。如果是VS Code的内置终端执行这个命令同样有效。别小看这一步很多“明明配好了环境变量但输出总是乱码”的求助最后都栽在这儿。5.4 HMCL启动器、Drozer找不到Java怎么办HMCL是Minecraft的一个启动器很多玩家为了启动游戏被要求安装Java。这里有个特殊点不同版本的Minecraft对Java版本要求不同老版本有大把模组要求Java 8新版本则要Java 17或21。装上Java之后HMCL还提示找不到多半是Path没配置好或者HMCL启动时没有读取到JAVA_HOME。解决办法很简单在HMCL设置里手动指定Java路径Windows上直接定位到你的JDK目录下的bin\javaw.exe就行。至于Drozer这类安全测试工具提示找不到Java其实也是PATH或JAVA_HOME配置问题。这类工具通常在命令行下运行它启动时依赖java命令能直接被系统找到。如果你安装JDK时用的用户变量而运行Drozer的终端是管理员身份打开的用户变量不一定会被继承所以有时候普通cmd下可以用Java管理员cmd下反而不行。建议把JAVA_HOME和Path配到系统变量里一劳永逸。5.5 几个容易被忽略的细节和经验之谈安装JDK后一定要重开所有已打开的命令行窗口。新手最常见的操作就是在旧的cmd窗口里输入java -version报错后怀疑配置有问题其实窗口早就被“冻结”了。不要手动删C:\Windows\System32下的java.exe有些软件会自动加进去。遇到版本冲突优先调整Path顺序而不是去系统目录里删文件以免误伤其他软件。使用echo %JAVA_HOME%验证变量是否设置成功这个命令也可以用在cmd窗口里快速检查。如果你在公司的电脑上安装注意可能需要管理员权限。如果java -version正常但每次安装软件、启动IDE都要提权可以考虑配置用户变量而不是系统变量能省掉不少UAC弹窗的烦扰。6. 安装完成后的验证与下一步开始6.1 写一个Hello World来验证整个工具链环境变量配好之后不能只看java -version就急着关页面。我建议你动手写一个简单的Hello World这一步能验证编辑器、JDK、运行时整条链路是否真的通了也顺便检查一下编码问题。假设你在D:\demo目录下新建Hello.java文件写入以下内容public class Hello { public static void main(String[] args) { System.out.println(Hello Java, 环境配置成功); } }然后在cmd里切换到文件所在目录依次执行javac Hello.java java Hello如果能看到一行中文输出说明javac编译正常、java运行正常、控制台编码也没问题。这里要特别说明javac Hello.java和java Hello这两个命令的输入格式不一样编译时带.java后缀运行时只带类名不带后缀。很多新手在这两个命令之间卡住报“找不到或无法加载主类”多半是把java Hello.java这种错误写法用上了。如果你执行javac时报“编码GBK的不可映射字符”说明文件保存的编码和系统默认编码不一致。Windows下最简单的解决办法是把代码文件用“另存为”方式改成ANSI编码中文Windows下即GBK或者坚持使用UTF-8编码然后去IDE里配置统一编码。我更推荐后者因为现在是UTF-8时代继续混用ANSI只会让项目的编码越来越乱。6.2 环境搭好后学习路线别跑偏装好了JDK学会敲java -version和javac -version其实只是万里长征第一步。很多人安装完JDK就开始到处找“java面试题”“java八股文”“java学习路线”我觉得顺序有点反了。安装环境是为了动手写代码不是为了背题。现在的建议是先把Java基础语法过一遍比如变量、数据类型、运算符、流程控制、数组、方法、面向对象、异常、集合框架、泛型、IO流、多线程、网络编程、反射等这些是地基地基本稳直接背面试题面试官多问两下就会露馅。很多人喜欢在收藏夹里堆一堆“java基础”“java面试大全”的标题最后连一个Hello World都没跑起来。我建议补一条把这篇文章收藏起来按照里面的步骤把环境装好然后找一本Java基础教程或者一套B站视频跟着敲至少二十个练习。代码量的积累是学Java唯一没法绕过的路径环境装得再好不写代码等于零。当你觉得基础语法熟练了再开始接触Spring、Spring Boot这些框架那时候看“java面试八股文”才有实际意义。6.3 一套环境多版本并存的使用心得最后结合我自己的实际经验再分享一个多版本JDK并存的使用方案这也是很多开发老司机的标配玩法。我在自己电脑上装了JDK 8和JDK 17两个版本。JAVA_HOME默认指向JDK 17这样日常开发、跑新框架不受影响但一旦需要跑老项目、维护几年前的公司系统我会打开命令行临时切换版本。Windows下用set JAVA_HOMED:\Java\jdk-8再执行set Path%JAVA_HOME%\bin;%PATH%在当前会话里就切到Java 8了。Linux/macOS类似执行export JAVA_HOME/usr/local/java/jdk-8 export PATH$JAVA_HOME/bin:$PATH。这个方案的核心思路是默认环境用新版本临时会话切旧版本既不影响日常开发又不会因为老项目把主环境搞乱。另外如果你用IDE比如IDEA或Eclipse可以在每个项目的Project Structure里单独指定SDK版本完全不依赖全局JAVA_HOME很多开发者其实都用这个方式来管理多版本平时根本不用手动切环境变量。其实装Java这件事从技术难度上说真的不大但因为它牵扯到很多细节比如版本选择、环境变量原理、路径冲突、编码格式一个没处理对就会让新人抓狂。希望这篇教程能帮你把环境一步到位地装好不再被环境问题拦住学习的脚步。