搞Java开发第一道坎永远不是语法而是先把这个叫JDK的东西在Windows上装好。我见过太多人卡在javac 不是内部或外部命令上气得把环境变量删了重配一遍一遍试最后发现只是忘了开新命令行窗口。这篇文章就把Windows安装JDK这件事从头到尾讲透从版本选择、安装包下载、环境变量配置到多JDK切换和常见报错排查全部按照实际动手的顺序来写。无论你是刚入门学Java还是要在老电脑上搭建开发环境照着做基本能一遍过。文章里涉及的命令、路径、配置项都是我实际用过的针对Windows 10和Windows 11都适用。我尽量不写那些“打开设置然后点下一步”的流水账而是告诉你每个步骤为什么这么做、不做什么会踩什么坑。毕竟安装JDK这事儿看起来简单真正自己从头弄一遍细节还真不少。1. 安装前必须想清楚的三个问题1.1 JDK版本怎么选没必要追新但要考虑稳定很多新手上来就下载最新版JDK比如现在官网默认推荐的可能是JDK 21甚至更新但我说句实话如果你是在学基础语法或者用的框架是Spring Boot 3.xJDK 17完全足够如果你要跑老项目Spring Boot 2.x、老版本Hadoop、或者某些商业组件那还需要JDK 8。从实际工作场景看目前企业里用的最多的还是JDK 8和JDK 11JDK 17逐渐成为主流。因为JDK 17是LTS长期支持版本Oracle官方会持续提供很多年的免费更新和安全补丁。相比之下JDK 9到JDK 16都是过渡版本没必要装。我给的建议是新项目用JDK 17老项目用JDK 8你要是拿不准先装17就行。装好一个主版本后后面再学多版本切换也会很方便。版本选择虽然看起来是软件版本号的问题但它直接影响后续IDE、构建工具Maven/Gradle和中间件比如Elasticsearch的兼容性。所以别只看“最新”要看你手头的项目生态要求什么。1.2 Oracle JDK、OpenJDK、Adoptium Temurin 到底怎么选这可能是最让人混淆的地方。简单说Oracle JDK是官方商业版以前是免费的后来变成收费授权模式再后来Oracle又开源了OpenJDK。现在很多开发者的选择其实围绕“免费、够用、更新及时”这三个维度。我个人推荐使用Adoptium Temurin就是Eclipse Adoptium项目出的OpenJDK发行版名字有点长但是免费、稳定、社区活跃而且支持Windows平台安装包。在国内网络环境不好的时候也可以使用清华大学的镜像站下载Adoptium的压缩包速度很快。除了Adoptium还有Amazon Corretto、Microsoft OpenJDK、Azul Zulu等它们都是OpenJDK的发行版代码基本一致只是后期维护方和打包方式不同。如果你有明确的商业授权顾虑或者公司指定了某个特定版本那就按公司要求来。个人学习、做开源项目、写小工具完全不用纠结Adoptium Temurin 17 绝对够用。1.3 安装方式exe安装包、解压版、还是包管理器Windows上安装JDK最常见的三种方式下载exe安装程序双击安装、下载zip/tar.gz解压后自己配环境变量、用包管理器自动安装。三种方式各有优劣。exe安装程序最省心它会自动写入注册表自动配置PATH虽然我建议装完自己检查一遍适合第一次接触Java的人。zip解压版的好处是不写注册表一个文件夹拷走就能用特别适合做多版本JDK管理或者想把JDK放在非C盘的情况。包管理器比如winget、或者通过choco适合习惯命令行操作的人一条命令装完但对新手来说不太直观出了问题反而不容易排查。我的建议是第一次安装用exe后面如果要做多版本切换再下载解压版放到统一目录不要混着装不然环境变量会乱。2. 从下载到安装完整实操步骤2.1 从哪里下载JDK比较靠谱先明确一个问题不要去那些乱七八糟的“JDK下载站”下载很多是捆绑广告或者修改过的版本。最安全的方式是去官方渠道。Oracle JDK官方下载地址Oracle官网的Java下载页面需要选择Windows x64 Installer。下载前需要勾选同意许可协议过程麻烦一点但安全。Adoptium官网adoptium.net进去后选择版本17、平台Windows、架构x64、安装包类型JDK和MSI或ZIP。如果你的网络访问这些国外站点慢可以用清华镜像https://mirrors.tuna.tsinghua.edu.cn/adoptium/路径下按版本组织比如17/jdk/x64/windows/里能看到zip和msi文件。有些国内云厂商也提供镜像但最好用清华源因为更新及时、信誉好。下载的时候注意区分.msi、.exe、.zip。MSI是微软安装器格式双击后由Windows Installer执行和exe一样能写注册表但MSI更便于企业批量部署和卸载。ZIP是绿色版解压就能用。我建议普通用户选择exe或msi喜欢干净环境的选ZIP。2.2 exe安装过程详解这几步别跳过双击安装包后先是欢迎界面点“Next”然后你会看到安装路径设置。默认安装路径一般是C:\Program Files\Java\jdk-17我不建议你修改因为带空格的路径按理说Java也能处理但万一以后写脚本碰见空格路径容易头大。你可以改成D:\Java\jdk-17这类无空格路径但一定要记住你装在哪后面配环境变量要用。再往下会提示选择“公共JRE”这是JDK 8时代遗留的习惯很多人会看见一个“公共JRE”功能组件。如果你用IDE如IntelliJ IDEA、Eclipse开发基本上不需要单独安装公共JRE因为JDK已经包含JRE而且IDE会直接用JDK。所以这里可以把这个组件禁用掉省点空间。安装完成后默认还会弹出“JavaFX”之类的说明不用管它。最需要确认的是安装目录下有没有bin文件夹以及里面有没有java.exe和javac.exe。这俩文件是整个安装的核心缺了哪一个后面都会出问题。2.3 解压版安装怎么配置才不出错如果你下载的是zip包首先把它解压到一个固定的目录我习惯放在D:\dev\jdk-17或者C:\dev\jdk-17总之别解压到下载文件夹因为以后找不到还容易误删。解压后你会看到一个和exe安装版几乎一样的目录结构里面有bin、conf、include、jmods、legal、lib等文件夹。真正要配置的就是环境变量这一步和exe安装的后半段一致需要把JAVA_HOME指向这个解压目录把%JAVA_HOME%\bin追加到PATH里。这里有个关键点解压版没有写注册表IDE或命令行程序有时候会通过注册表查找JDK所以遇到“找不到JDK”的问题时解压版需要额外配置。不过对于绝大多数开发场景环境变量配置好就够了。3. 环境变量配置让Windows“认识”Java3.1 JAVA_HOME、PATH、CLASSPATH 分别是什么角色刚接触Java的小伙伴经常被这三个名词搞晕。我用大白话解释一下。JAVA_HOME是一个指向JDK安装根目录的环境变量它的作用是给其他工具提供参考。比如你装了MavenMaven要运行就要找Java它会先看JAVA_HOME指向哪里。所以JAVA_HOME必须指向JDK的根目录比如C:\Program Files\Java\jdk-17并不是指向bin子目录也不是指向更外层。PATH是操作系统用来查找可执行文件的路径列表。你在命令行输入java系统就去PATH里一个个目录找有没有java.exe找到了就能执行。所以必须把%JAVA_HOME%\bin加进PATH两个变量配合起来以后你想换版本时只需要改JAVA_HOME一个值PATH不用动。CLASSPATH是Java编译器查找类库的路径但现代Java开发中运行Java程序时默认会包含当前目录和系统类库绝大多数情况下你不需要手动设置CLASSPATH。所以网上那些让你新建CLASSPATH变量的教程大多数是过时的。如果配错反而可能干扰程序运行。我的建议不要配置CLASSPATH。3.2 一步步配置环境变量图形界面操作我用Windows 11的界面演示Windows 10大同小异。先打开“设置” - “系统” - “关于” - “高级系统设置”或者按快捷键Win R输入sysdm.cpl回车在“高级”选项卡里点击“环境变量”。在弹出的窗口中上面是“用户变量”下面是“系统变量”。关键点来了如果你只给当前用户用配置用户变量就好如果你想让这台机器上所有用户都能用就配置系统变量。我一般推荐配置系统变量因为开发机通常就一个用户而且某些工具比如Tomcat通过Windows服务运行需要在系统级才能读到JAVA_HOME。在“系统变量”区域点击“新建”变量名JAVA_HOME变量值你的JDK路径比如C:\Program Files\Java\jdk-17或D:\dev\jdk-17然后在系统变量里找到Path双击打开点击“新建”添加一行%JAVA_HOME%\bin。注意有的Windows版本显示为一行一个路径你直接新建即可有的版本是分号分隔的长字符串那就在末尾加;%JAVA_HOME%\bin。完成后一路点“确定”保存。这里有个容易踩的坑如果你在“用户变量”里也配了PATH里有旧的Java路径它会在系统变量的PATH之前被搜索导致你改了JAVA_HOME但命令行用的还是旧版本。所以一定要检查所有PATH里的Java相关条目别留死角。3.3 命令行配置环境变量的玩法扩展对于习惯命令行的朋友可以用setx命令快速配置环境变量。但注意setx有个坑它会截断超过1024个字符的内容而且修改的是用户环境变量不会立刻体现在当前命令行窗口需要新开窗口。举个例子setx JAVA_HOME C:\Program Files\Java\jdk-17 setx Path %Path%;%JAVA_HOME%\bin第二条命令的做法其实很不建议因为%Path%展开的是当前会话的Path可能会把系统变量和用户变量混合后用当前值覆盖回去容易造成污染。所以这条命令我写了是提醒你少用。比较稳的方式是写一个批处理脚本在要用的命令行会话里临时设置set JAVA_HOMEC:\Program Files\Java\jdk-17 set PATH%JAVA_HOME%\bin;%PATH%这样只对当前窗口生效适合测试。真实项目里我更推荐直接用图形界面配好一劳永逸。4. 验证安装结果与跑通第一个Java程序4.1 三条命令确认安装是否成功配置完环境变量后最关键的一步就是验证。关键是一定要重新开一个新的命令行窗口不要用配置前打开的旧窗口因为旧窗口的环境变量还是旧值。点击“开始”菜单输入“cmd”或者“PowerShell”打开新窗口依次输入java -version javac -version echo %JAVA_HOME%正常情况下你会看到类似下面的输出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 C:\Program Files\Java\jdk-17如果java -version有输出但javac -version报错说明%JAVA_HOME%\bin在PATH里配得不对或者JAVA_HOME指向到了jre而不是jdk务必回去检查。PowerShell用户还可以用echo $env:JAVA_HOME查看变量用Get-Command java查看java命令的实际路径这能帮你判断当前用的到底是哪个JDK。4.2 编写HelloWorld验证“编译运行”链路环境验证通过后我建议你立即写一个最简单的Java程序把编译和运行链路走通避免以后第一次编译时再遇到问题。在某个工作目录下新建文本文件Hello.java内容public class Hello { public static void main(String[] args) { System.out.println(Hello, JDK!); } }注意文件名必须和类名完全一致包括大小写否则javac会报错。然后在该目录下执行javac Hello.java java Hello这里有个很多新手容易犯的错运行java Hello时不要带.class后缀也不要带.java后缀。正确的是java Hello类名。如果你执行java Hello.class会得到 “找不到或无法加载主类” 的错误。如果看到控制台输出Hello, JDK!恭喜你环境彻底没问题了。此时目录下会出现一个Hello.class文件这是编译后的字节码文件Java虚拟机JVM执行的就是这个文件。4.3 验证环节最容易踩的三个坑第一个坑就是之前的命令行窗口没关。即使环境变量配置没有错旧窗口里依然显示“不是内部或外部命令”。这种心理落差我太熟悉了所以验证前一定新开窗口。第二个坑是32位和64位混淆。如果你下载的是32位JDK安装在64位Windows上虽然能装但会在某些场景下爆内存不足而且和64位工具链不兼容。现在基本都是64位系统下载时看清楚平台标识是x64还是x86选x64。第三个坑是安装后找不到javac。如果java -version正常而javac异常大概率你装的是JRE而不是JDK或者下载时选了“JRE”安装包。记住开发必须装JDK里面才包含编译器。5. 常见问题与排查经验速查5.1 “不是内部或外部命令”的完整排查思路这个报错信息在Windows命令行里太经典了它的意思是操作系统在PATH指定的所有目录里都没找到对应的可执行文件。第一步确认JDK到底装没装。去你的JDK目录\bin下看看有没有java.exe和javac.exe。如果没有说明安装不完整重新装。第二步检查JAVA_HOME是否指向根目录。有些人配置JAVA_HOME时手滑加了个\bin比如C:\Program Files\Java\jdk-17\bin那后面PATH里变成\bin\bin必然找不到。第三步检查PATH里有没有%JAVA_HOME%\bin这一条。注意不要写成%JAVA_HOME%bin因为变量通常以反斜杠结尾或没有PATH里写%JAVA_HOME%\bin才是最稳妥的。第四步如果配置都正确重新打开命令行再试。如果还不行再看看是不是在“用户变量”和“系统变量”里都被覆盖了。我自己的习惯是配置完直接以管理员身份打开PowerShell输入where.exe java。这个命令会列出所有被识别的java路径顺序越靠前的越优先。如果第一个路径不是你要的版本说明PATH顺序不对需要调整。5.2 电脑上多个JDK版本怎么切换才不乱老项目用JDK 8新项目用JDK 17这是很多开发者都遇到过的场景。多版本切换的核心是改JAVA_HOME而不是频繁卸载安装。我的做法是在统一目录下保留多个解压版JDK比如D:\dev\jdk8 D:\dev\jdk17然后在系统变量里不直接设置JAVA_HOME为具体版本而是设置一个软变量指向当前使用的版本目录在Windows图形界面里不支持软链接环境变量嵌套其实可以用自己新建一个中间变量例如JAVA_HOMED:\dev\jdk17然后PATH里写%JAVA_HOME%\bin当你想切到8时把JAVA_HOME改成D:\dev\jdk8就行。如果你嫌手动改麻烦可以写两个批处理脚本比如jdk17.bat里设置环境变量后调用命令提示符但这仅对当前窗口有效。想全局切换还是得改系统变量。另外很多IDE比如IntelliJ IDEA里可以单独配置每个项目用的JDK所以就算系统默认是17你依然可以在项目设置里指到jdk8不一定非要改全局。这样比切换全局变量更灵活。5.3 从官网和镜像站下载时总是失败怎么办这个问题的常见原因是网络波动或者国外站点连接慢。我实测过Oracle官网下载JDK时经常需要点很多按钮而且大文件拉到一半断了。这种情况优先用清华镜像。以Adoptium Temurin 8为例镜像路径是https://mirrors.tuna.tsinghua.edu.cn/adoptium/8/jdk/x64/windows/你直接浏览器打开会看到一堆文件名比如OpenJDK8U-jdk_x64_windows_hotspot_8u442b06.zip。选zip包下载后解压到本地再配置环境变量一样能用。还有很多企业开发环境要求离线和内网安装这时候最好在能上网的机器上下载好对应的安装包或zip包拷贝到内网机器解压配置。注意内网机器如果只有32位系统就只能下载x86版本不能混用。5.4 IDE和构建工具里找不到JDK怎么办环境变量配好之后IntelliJ IDEA、Eclipse、VS Code这些工具基本都能自动识别。但也有特殊情况你之前装过其他版本IDE缓存记着了老路径导致识别错误。在IntelliJ IDEA里如果你新建项目时提示找不到JDK可以通过File - Project Structure - SDKs - - Add JDK手动定位到JDK根目录。Eclipse里是Window - Preferences - Java - Installed JREs - Add注意要选择Standard VM然后指定JDK目录。使用Maven或Gradle时如果命令行构建报错找不到Java先看mvn -v输出的Java版本如果和你预期不符要么改JAVA_HOME要么在settings.xml或gradle.properties里单独指定Java路径。有些情况下IDE自带的JBRJetBrains Runtime会和系统JDK混淆但其实IDE编译时用的是你项目指定的JDK不影响。5.5 安装完之后还能做点什么既然JDK装好了我顺带提一下更高效的环境组合。新手往往只装了JDK后面还会遇到Maven、Git、Docker这些工具搞得头大。我的经验是装好JDK后下一步就装IDEA Community版免费再装一个Git for Windows然后配好Maven的settings.xml使用国内镜像。这一套下来日常Java开发就够用了。如果你的机器上已经有Docker Desktop想练手Java服务端部署可以配合JDK一起用。Windows下Docker Desktop需要开启WSL 2后端然后在容器里跑基于OpenJDK的镜像。不过这属于另外一个大话题以后有机会再单独聊。最后再分享一个实用小技巧。如果你觉得自己经常需要临时在某个目录运行Java程序可以在这个目录下创建一个run.bat文件内容就一行java -cp . YourMainClass以后修改代码后先javac YourMainClass.java再双击bat就能运行省得每次敲命令。对于刚开始学Java的同学来说这种小工具能减少很多摩擦感。Windows上安装JDK这件事说难不难说简单也不是双击下一步就行。版本选型、环境变量、PATH顺序、多版本共存每一环都可能出问题。但只要按照“下载、安装、配变量、新窗口验证、写HelloWorld”这个路径走一遍后面就顺了。我自己也经历过反复配置失败的过程后来总结下来就是别偷懒查看Path条目的实际展开值别省事用旧窗口验证别把CLASSPATH加进系统变量。记住这三条你的JDK安装基本不会出大问题。 
长河君 · 2026/10/1 2:04:10 · 阅读 1.2k Windows安装JDK完全指南：从版本选择到环境变量配置与排错
搞Java开发第一道坎永远不是语法而是先把这个叫JDK的东西在Windows上装好。我见过太多人卡在javac 不是内部或外部命令上气得把环境变量删了重配一遍一遍试最后发现只是忘了开新命令行窗口。这篇文章就把Windows安装JDK这件事从头到尾讲透从版本选择、安装包下载、环境变量配置到多JDK切换和常见报错排查全部按照实际动手的顺序来写。无论你是刚入门学Java还是要在老电脑上搭建开发环境照着做基本能一遍过。文章里涉及的命令、路径、配置项都是我实际用过的针对Windows 10和Windows 11都适用。我尽量不写那些“打开设置然后点下一步”的流水账而是告诉你每个步骤为什么这么做、不做什么会踩什么坑。毕竟安装JDK这事儿看起来简单真正自己从头弄一遍细节还真不少。1. 安装前必须想清楚的三个问题1.1 JDK版本怎么选没必要追新但要考虑稳定很多新手上来就下载最新版JDK比如现在官网默认推荐的可能是JDK 21甚至更新但我说句实话如果你是在学基础语法或者用的框架是Spring Boot 3.xJDK 17完全足够如果你要跑老项目Spring Boot 2.x、老版本Hadoop、或者某些商业组件那还需要JDK 8。从实际工作场景看目前企业里用的最多的还是JDK 8和JDK 11JDK 17逐渐成为主流。因为JDK 17是LTS长期支持版本Oracle官方会持续提供很多年的免费更新和安全补丁。相比之下JDK 9到JDK 16都是过渡版本没必要装。我给的建议是新项目用JDK 17老项目用JDK 8你要是拿不准先装17就行。装好一个主版本后后面再学多版本切换也会很方便。版本选择虽然看起来是软件版本号的问题但它直接影响后续IDE、构建工具Maven/Gradle和中间件比如Elasticsearch的兼容性。所以别只看“最新”要看你手头的项目生态要求什么。1.2 Oracle JDK、OpenJDK、Adoptium Temurin 到底怎么选这可能是最让人混淆的地方。简单说Oracle JDK是官方商业版以前是免费的后来变成收费授权模式再后来Oracle又开源了OpenJDK。现在很多开发者的选择其实围绕“免费、够用、更新及时”这三个维度。我个人推荐使用Adoptium Temurin就是Eclipse Adoptium项目出的OpenJDK发行版名字有点长但是免费、稳定、社区活跃而且支持Windows平台安装包。在国内网络环境不好的时候也可以使用清华大学的镜像站下载Adoptium的压缩包速度很快。除了Adoptium还有Amazon Corretto、Microsoft OpenJDK、Azul Zulu等它们都是OpenJDK的发行版代码基本一致只是后期维护方和打包方式不同。如果你有明确的商业授权顾虑或者公司指定了某个特定版本那就按公司要求来。个人学习、做开源项目、写小工具完全不用纠结Adoptium Temurin 17 绝对够用。1.3 安装方式exe安装包、解压版、还是包管理器Windows上安装JDK最常见的三种方式下载exe安装程序双击安装、下载zip/tar.gz解压后自己配环境变量、用包管理器自动安装。三种方式各有优劣。exe安装程序最省心它会自动写入注册表自动配置PATH虽然我建议装完自己检查一遍适合第一次接触Java的人。zip解压版的好处是不写注册表一个文件夹拷走就能用特别适合做多版本JDK管理或者想把JDK放在非C盘的情况。包管理器比如winget、或者通过choco适合习惯命令行操作的人一条命令装完但对新手来说不太直观出了问题反而不容易排查。我的建议是第一次安装用exe后面如果要做多版本切换再下载解压版放到统一目录不要混着装不然环境变量会乱。2. 从下载到安装完整实操步骤2.1 从哪里下载JDK比较靠谱先明确一个问题不要去那些乱七八糟的“JDK下载站”下载很多是捆绑广告或者修改过的版本。最安全的方式是去官方渠道。Oracle JDK官方下载地址Oracle官网的Java下载页面需要选择Windows x64 Installer。下载前需要勾选同意许可协议过程麻烦一点但安全。Adoptium官网adoptium.net进去后选择版本17、平台Windows、架构x64、安装包类型JDK和MSI或ZIP。如果你的网络访问这些国外站点慢可以用清华镜像https://mirrors.tuna.tsinghua.edu.cn/adoptium/路径下按版本组织比如17/jdk/x64/windows/里能看到zip和msi文件。有些国内云厂商也提供镜像但最好用清华源因为更新及时、信誉好。下载的时候注意区分.msi、.exe、.zip。MSI是微软安装器格式双击后由Windows Installer执行和exe一样能写注册表但MSI更便于企业批量部署和卸载。ZIP是绿色版解压就能用。我建议普通用户选择exe或msi喜欢干净环境的选ZIP。2.2 exe安装过程详解这几步别跳过双击安装包后先是欢迎界面点“Next”然后你会看到安装路径设置。默认安装路径一般是C:\Program Files\Java\jdk-17我不建议你修改因为带空格的路径按理说Java也能处理但万一以后写脚本碰见空格路径容易头大。你可以改成D:\Java\jdk-17这类无空格路径但一定要记住你装在哪后面配环境变量要用。再往下会提示选择“公共JRE”这是JDK 8时代遗留的习惯很多人会看见一个“公共JRE”功能组件。如果你用IDE如IntelliJ IDEA、Eclipse开发基本上不需要单独安装公共JRE因为JDK已经包含JRE而且IDE会直接用JDK。所以这里可以把这个组件禁用掉省点空间。安装完成后默认还会弹出“JavaFX”之类的说明不用管它。最需要确认的是安装目录下有没有bin文件夹以及里面有没有java.exe和javac.exe。这俩文件是整个安装的核心缺了哪一个后面都会出问题。2.3 解压版安装怎么配置才不出错如果你下载的是zip包首先把它解压到一个固定的目录我习惯放在D:\dev\jdk-17或者C:\dev\jdk-17总之别解压到下载文件夹因为以后找不到还容易误删。解压后你会看到一个和exe安装版几乎一样的目录结构里面有bin、conf、include、jmods、legal、lib等文件夹。真正要配置的就是环境变量这一步和exe安装的后半段一致需要把JAVA_HOME指向这个解压目录把%JAVA_HOME%\bin追加到PATH里。这里有个关键点解压版没有写注册表IDE或命令行程序有时候会通过注册表查找JDK所以遇到“找不到JDK”的问题时解压版需要额外配置。不过对于绝大多数开发场景环境变量配置好就够了。3. 环境变量配置让Windows“认识”Java3.1 JAVA_HOME、PATH、CLASSPATH 分别是什么角色刚接触Java的小伙伴经常被这三个名词搞晕。我用大白话解释一下。JAVA_HOME是一个指向JDK安装根目录的环境变量它的作用是给其他工具提供参考。比如你装了MavenMaven要运行就要找Java它会先看JAVA_HOME指向哪里。所以JAVA_HOME必须指向JDK的根目录比如C:\Program Files\Java\jdk-17并不是指向bin子目录也不是指向更外层。PATH是操作系统用来查找可执行文件的路径列表。你在命令行输入java系统就去PATH里一个个目录找有没有java.exe找到了就能执行。所以必须把%JAVA_HOME%\bin加进PATH两个变量配合起来以后你想换版本时只需要改JAVA_HOME一个值PATH不用动。CLASSPATH是Java编译器查找类库的路径但现代Java开发中运行Java程序时默认会包含当前目录和系统类库绝大多数情况下你不需要手动设置CLASSPATH。所以网上那些让你新建CLASSPATH变量的教程大多数是过时的。如果配错反而可能干扰程序运行。我的建议不要配置CLASSPATH。3.2 一步步配置环境变量图形界面操作我用Windows 11的界面演示Windows 10大同小异。先打开“设置” - “系统” - “关于” - “高级系统设置”或者按快捷键Win R输入sysdm.cpl回车在“高级”选项卡里点击“环境变量”。在弹出的窗口中上面是“用户变量”下面是“系统变量”。关键点来了如果你只给当前用户用配置用户变量就好如果你想让这台机器上所有用户都能用就配置系统变量。我一般推荐配置系统变量因为开发机通常就一个用户而且某些工具比如Tomcat通过Windows服务运行需要在系统级才能读到JAVA_HOME。在“系统变量”区域点击“新建”变量名JAVA_HOME变量值你的JDK路径比如C:\Program Files\Java\jdk-17或D:\dev\jdk-17然后在系统变量里找到Path双击打开点击“新建”添加一行%JAVA_HOME%\bin。注意有的Windows版本显示为一行一个路径你直接新建即可有的版本是分号分隔的长字符串那就在末尾加;%JAVA_HOME%\bin。完成后一路点“确定”保存。这里有个容易踩的坑如果你在“用户变量”里也配了PATH里有旧的Java路径它会在系统变量的PATH之前被搜索导致你改了JAVA_HOME但命令行用的还是旧版本。所以一定要检查所有PATH里的Java相关条目别留死角。3.3 命令行配置环境变量的玩法扩展对于习惯命令行的朋友可以用setx命令快速配置环境变量。但注意setx有个坑它会截断超过1024个字符的内容而且修改的是用户环境变量不会立刻体现在当前命令行窗口需要新开窗口。举个例子setx JAVA_HOME C:\Program Files\Java\jdk-17 setx Path %Path%;%JAVA_HOME%\bin第二条命令的做法其实很不建议因为%Path%展开的是当前会话的Path可能会把系统变量和用户变量混合后用当前值覆盖回去容易造成污染。所以这条命令我写了是提醒你少用。比较稳的方式是写一个批处理脚本在要用的命令行会话里临时设置set JAVA_HOMEC:\Program Files\Java\jdk-17 set PATH%JAVA_HOME%\bin;%PATH%这样只对当前窗口生效适合测试。真实项目里我更推荐直接用图形界面配好一劳永逸。4. 验证安装结果与跑通第一个Java程序4.1 三条命令确认安装是否成功配置完环境变量后最关键的一步就是验证。关键是一定要重新开一个新的命令行窗口不要用配置前打开的旧窗口因为旧窗口的环境变量还是旧值。点击“开始”菜单输入“cmd”或者“PowerShell”打开新窗口依次输入java -version javac -version echo %JAVA_HOME%正常情况下你会看到类似下面的输出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 C:\Program Files\Java\jdk-17如果java -version有输出但javac -version报错说明%JAVA_HOME%\bin在PATH里配得不对或者JAVA_HOME指向到了jre而不是jdk务必回去检查。PowerShell用户还可以用echo $env:JAVA_HOME查看变量用Get-Command java查看java命令的实际路径这能帮你判断当前用的到底是哪个JDK。4.2 编写HelloWorld验证“编译运行”链路环境验证通过后我建议你立即写一个最简单的Java程序把编译和运行链路走通避免以后第一次编译时再遇到问题。在某个工作目录下新建文本文件Hello.java内容public class Hello { public static void main(String[] args) { System.out.println(Hello, JDK!); } }注意文件名必须和类名完全一致包括大小写否则javac会报错。然后在该目录下执行javac Hello.java java Hello这里有个很多新手容易犯的错运行java Hello时不要带.class后缀也不要带.java后缀。正确的是java Hello类名。如果你执行java Hello.class会得到 “找不到或无法加载主类” 的错误。如果看到控制台输出Hello, JDK!恭喜你环境彻底没问题了。此时目录下会出现一个Hello.class文件这是编译后的字节码文件Java虚拟机JVM执行的就是这个文件。4.3 验证环节最容易踩的三个坑第一个坑就是之前的命令行窗口没关。即使环境变量配置没有错旧窗口里依然显示“不是内部或外部命令”。这种心理落差我太熟悉了所以验证前一定新开窗口。第二个坑是32位和64位混淆。如果你下载的是32位JDK安装在64位Windows上虽然能装但会在某些场景下爆内存不足而且和64位工具链不兼容。现在基本都是64位系统下载时看清楚平台标识是x64还是x86选x64。第三个坑是安装后找不到javac。如果java -version正常而javac异常大概率你装的是JRE而不是JDK或者下载时选了“JRE”安装包。记住开发必须装JDK里面才包含编译器。5. 常见问题与排查经验速查5.1 “不是内部或外部命令”的完整排查思路这个报错信息在Windows命令行里太经典了它的意思是操作系统在PATH指定的所有目录里都没找到对应的可执行文件。第一步确认JDK到底装没装。去你的JDK目录\bin下看看有没有java.exe和javac.exe。如果没有说明安装不完整重新装。第二步检查JAVA_HOME是否指向根目录。有些人配置JAVA_HOME时手滑加了个\bin比如C:\Program Files\Java\jdk-17\bin那后面PATH里变成\bin\bin必然找不到。第三步检查PATH里有没有%JAVA_HOME%\bin这一条。注意不要写成%JAVA_HOME%bin因为变量通常以反斜杠结尾或没有PATH里写%JAVA_HOME%\bin才是最稳妥的。第四步如果配置都正确重新打开命令行再试。如果还不行再看看是不是在“用户变量”和“系统变量”里都被覆盖了。我自己的习惯是配置完直接以管理员身份打开PowerShell输入where.exe java。这个命令会列出所有被识别的java路径顺序越靠前的越优先。如果第一个路径不是你要的版本说明PATH顺序不对需要调整。5.2 电脑上多个JDK版本怎么切换才不乱老项目用JDK 8新项目用JDK 17这是很多开发者都遇到过的场景。多版本切换的核心是改JAVA_HOME而不是频繁卸载安装。我的做法是在统一目录下保留多个解压版JDK比如D:\dev\jdk8 D:\dev\jdk17然后在系统变量里不直接设置JAVA_HOME为具体版本而是设置一个软变量指向当前使用的版本目录在Windows图形界面里不支持软链接环境变量嵌套其实可以用自己新建一个中间变量例如JAVA_HOMED:\dev\jdk17然后PATH里写%JAVA_HOME%\bin当你想切到8时把JAVA_HOME改成D:\dev\jdk8就行。如果你嫌手动改麻烦可以写两个批处理脚本比如jdk17.bat里设置环境变量后调用命令提示符但这仅对当前窗口有效。想全局切换还是得改系统变量。另外很多IDE比如IntelliJ IDEA里可以单独配置每个项目用的JDK所以就算系统默认是17你依然可以在项目设置里指到jdk8不一定非要改全局。这样比切换全局变量更灵活。5.3 从官网和镜像站下载时总是失败怎么办这个问题的常见原因是网络波动或者国外站点连接慢。我实测过Oracle官网下载JDK时经常需要点很多按钮而且大文件拉到一半断了。这种情况优先用清华镜像。以Adoptium Temurin 8为例镜像路径是https://mirrors.tuna.tsinghua.edu.cn/adoptium/8/jdk/x64/windows/你直接浏览器打开会看到一堆文件名比如OpenJDK8U-jdk_x64_windows_hotspot_8u442b06.zip。选zip包下载后解压到本地再配置环境变量一样能用。还有很多企业开发环境要求离线和内网安装这时候最好在能上网的机器上下载好对应的安装包或zip包拷贝到内网机器解压配置。注意内网机器如果只有32位系统就只能下载x86版本不能混用。5.4 IDE和构建工具里找不到JDK怎么办环境变量配好之后IntelliJ IDEA、Eclipse、VS Code这些工具基本都能自动识别。但也有特殊情况你之前装过其他版本IDE缓存记着了老路径导致识别错误。在IntelliJ IDEA里如果你新建项目时提示找不到JDK可以通过File - Project Structure - SDKs - - Add JDK手动定位到JDK根目录。Eclipse里是Window - Preferences - Java - Installed JREs - Add注意要选择Standard VM然后指定JDK目录。使用Maven或Gradle时如果命令行构建报错找不到Java先看mvn -v输出的Java版本如果和你预期不符要么改JAVA_HOME要么在settings.xml或gradle.properties里单独指定Java路径。有些情况下IDE自带的JBRJetBrains Runtime会和系统JDK混淆但其实IDE编译时用的是你项目指定的JDK不影响。5.5 安装完之后还能做点什么既然JDK装好了我顺带提一下更高效的环境组合。新手往往只装了JDK后面还会遇到Maven、Git、Docker这些工具搞得头大。我的经验是装好JDK后下一步就装IDEA Community版免费再装一个Git for Windows然后配好Maven的settings.xml使用国内镜像。这一套下来日常Java开发就够用了。如果你的机器上已经有Docker Desktop想练手Java服务端部署可以配合JDK一起用。Windows下Docker Desktop需要开启WSL 2后端然后在容器里跑基于OpenJDK的镜像。不过这属于另外一个大话题以后有机会再单独聊。最后再分享一个实用小技巧。如果你觉得自己经常需要临时在某个目录运行Java程序可以在这个目录下创建一个run.bat文件内容就一行java -cp . YourMainClass以后修改代码后先javac YourMainClass.java再双击bat就能运行省得每次敲命令。对于刚开始学Java的同学来说这种小工具能减少很多摩擦感。Windows上安装JDK这件事说难不难说简单也不是双击下一步就行。版本选型、环境变量、PATH顺序、多版本共存每一环都可能出问题。但只要按照“下载、安装、配变量、新窗口验证、写HelloWorld”这个路径走一遍后面就顺了。我自己也经历过反复配置失败的过程后来总结下来就是别偷懒查看Path条目的实际展开值别省事用旧窗口验证别把CLASSPATH加进系统变量。记住这三条你的JDK安装基本不会出大问题。