先说你最可能遇到的情况照着网上的教程一步步操作到了最后验证环境变量的那一步打开命令行输入java -version版本号能出来心里刚要松口气结果再输javac -version直接给你来一句“不是内部或外部命令”。我当年第一次配 JDK 的时候就卡在这个莫名其妙的地方后来把环境变量翻来覆去检查了好几遍才发现问题出在安装时 Oracle 自动写入 Path 的一个路径上。这篇教程就沿着 Windows 10 上 JDK 下载、安装、配置的完整流程走一遍。我会把每一步操作背后的原理也讲清楚不是为了凑字数而是因为很多坑都是因为你只知道“怎么做”、不知道“为什么这么做”才踩进去的。这篇内容适合刚入门 Java、准备搭开发环境的新手也适合之前配过但从没完全搞懂、想一次性把环境变量这件事彻底弄明白的同学。1. 先弄清楚 JDK、JRE 和环境变量到底在干什么1.1 JDK 和 JRE别把两个“J”开头的搞混很多新手一上来就看下载页面发现又是 JDK 又是 JRE直接懵了。简单说JDK 是 Java Development Kit是“开发工具包”里面装着编译器javac、运行工具java、打包工具jar、文档生成工具javadoc这些开发时要用到的东西。JRE 是 Java Runtime Environment是“运行环境”只负责把编译好的 Java 程序跑起来里面没有编译器。打个比方JDK 是一整套厨房锅碗瓢盆、食材加工设备都有你写菜谱、做菜都得靠它JRE 是微波炉你只需要把做好的菜热一热吃掉。所以如果你想自己写 Java 代码、把它编译成可运行程序必须装 JDK。好消息是现在 JDK 安装包里已经自带了运行环境装了 JDK 就足够不用单独再装 JRE。安装完之后你会在 JDK 安装目录下看到bin文件夹里面躺着java.exe和javac.exe这两个核心程序。javac负责把.java源码编译成.class字节码java负责启动虚拟机执行这个字节码。后面我们配置环境变量所有操作都是为了让系统能找到这两个文件。1.2 环境变量是个什么东西为什么非配不可Windows 系统在执行你输入的命令时并不是全盘搜索这个程序藏在哪里而是按顺序查找一个叫 Path 的环境变量里列出的目录。如果你在命令行里输入javac然后回车系统会在“当前目录”和“Path 中记录的所有目录”里找有没有叫这个名字的.exe文件。找不到就会提示“不是内部或外部命令也不是可运行的程序或批处理文件”。也就是说如果不把 JDK 的bin目录加进 Path那系统根本不知道你在说什么。这不是 JDK 没装好而是你装了工具却没告诉系统“工具放在哪个位置”。而JAVA_HOME这个变量又是另一层用途。像 IntelliJ IDEA、Eclipse、Maven、Tomcat 这类软件启动时会主动通过JAVA_HOME去定位 JDK 的安装根目录。比如 Maven 启动脚本里会用%JAVA_HOME%\bin\java这种写法来调用 Java。所以配置JAVA_HOME本质上是给这些主流开发工具提供一个统一入口。这样做还有一个好处以后你想升级 JDK 版本只需要把JAVA_HOME的值改成新版本的安装路径Path 里那一句%JAVA_HOME%\bin完全不用动。这也是所有教程都推荐配置 JAVA_HOME而不是直接把C:\Program Files\Java\jdk-17\bin写死到 Path 里的原因。1.3 该装哪个版本JDK 8、11、17 还是 21版本选择是个老生常谈的话题也是评论区最容易吵起来的话题。我说下自己的建议你按实际场景选就行。版本类型适合场景JDK 8经典老版本很多旧项目、老框架还在用企业存量极大JDK 11长期支持版本介于中间的一个过渡版本有些框架兼容性需要调整JDK 17长期支持版本目前最主流的新项目选择Spring Boot 3 依赖 17 及以上JDK 21长期支持版本较新的长期支持版本想尝鲜可以用我个人建议如果是刚学 Java、没有任何历史包袱直接装 JDK 17 或 JDK 21。原因很简单新版本对 Java 语言特性的支持更完整学习周期内不会遇到“代码写法没问题但编译器版本太旧不支持”这种破事。如果你接下来要学 Spring Boot那就更要选 JDK 17 起步因为新版的 Spring Boot 要求就是 17 起步。如果只是临时跑一个老项目再考虑 JDK 8。这里补充一句关于 OpenJDK 的闲话。Oracle JDK 之外有很多免费可用的 OpenJDK 构建版本比如 Eclipse Temurin、Adoptium 等两者在命令行使用、环境变量配置上没有区别。教程里我以 Oracle JDK 为例讲解操作完全适用于其他发行版。2. 下载 JDK版本、渠道和易踩的坑2.1 下载前先确认系统是 64 位还是 32 位Windows 10 现在绝大多数都是 64 位系统但保不齐有些老电脑还在用 32 位。区别方法很简单右键“此电脑”选“属性”在“系统类型”一栏能看到。如果是 64 位系统下载Windows x64 Installer文件后缀一般是.exe体积大约 150MB 到 200MB。如果是 32 位系统需要下载 x86 版本但说实话32 位的 JDK 新版本基本已经停止提供这种机器最好的出路还是重装成 64 位系统。还要注意别手滑下载成.tar.gz或.zip压缩包。压缩包版本也能用配置环境变量的思路也一样只是对于新手来说.exe安装程序的下一步下一步操作更友好。我建议一律用Windows x64 Installer。2.2 官方下载页和国内镜像怎么选优先去 Oracle 官网下载。这里有个小坑Oracle 官网首页往往让你先看到甲骨文的数据库、云服务产品Java 下载还得自己找入口。你可以在搜索框搜Java SE Downloads或者直接访问 Oracle 的 Java Downloads 页面。在下载列表里你要找的是“Windows x64 Installer”那一行。点进去之后有些页面会先让你勾选 “I reviewed and accept the Oracle Technology Network License Agreement”勾好之后按钮才会变成可点击状态。有同学反映明明点了下载却一直不动大概率是这一步没操作。国内网络环境下从官网下载偶尔会很慢甚至下载到一半断掉。这时候可以用国内知名镜像站下载。例如部分高校开源软件镜像站、云厂商的镜像站里都有 JDK 的镜像副本速度稳定很多。下完之后校验一下文件大小是否和官网标称一致再继续安装。有杀毒软件的朋友可能会被提示安装包被拦截一般是因为安装包需要写入系统目录属于正常行为添加信任后放行即可。2.3 安装时路径怎么选最省心双击安装包之后很快就到选择安装路径这一步。有些同学喜欢全部用默认路径即C:\Program Files\Java\jdk-17这没问题有些同学喜欢把开发工具统一放在 D 盘比如D:\Java\jdk-17这也很好。但有一条硬性建议安装路径里别带中文也别出现空格和特殊符号。虽然 Java 本身对带空格的路径兼容性已经不错但后续配合 Maven、Tomcat、IDEA 使用时某些老旧的脚本和插件在解析路径时会出现意想不到的问题。所以如果你想改路径建议改成类似D:\Java\jdk-17这样简短干净的目录。安装过程中安装程序可能会问你要不要安装“公共 JRE”Public JRE如果你看到这个勾选项不勾选也是可以的。因为 JDK 内部已经自带一套完整的运行环境公共 JRE 只是额外安装到另一个目录对开发来说不是必需品。保持最小化安装后续排查问题也方便。3. Windows 10 上的安装与环境变量配置实操3.1 一步一步配置 JAVA_HOME安装完成之后我们要进入重头戏。右键“此电脑”选择“属性”再点左侧的“高级系统设置”会弹出“系统属性”窗口点击右下方的“环境变量”按钮。这里要注意界面里分成上下两个区域上面是“用户变量”下面是“系统变量”。我们要操作的是下面的“系统变量”区域尽量别配到用户变量里。点击“系统变量”下方的“新建”按钮变量名填JAVA_HOME变量值填你 JDK 的实际安装根目录。比如我装的是 JDK 17默认路径是C:\Program Files\Java\jdk-17那变量值就填这一行。注意两点一是不要再往后面加bin二是结尾不要加分号。这里填的是根目录javac等程序是在根目录下的bin子目录里。为什么推荐配系统变量而不是用户变量因为有些开发工具和命令是在不同用户账户下运行的配到系统变量里所有用户、所有服务都能读到省去很多权限层面的奇怪问题。3.2 修改 Path让系统能找到 javac还是在“系统变量”列表里找到Path双击它Windows 10 会弹出一个按行展示的编辑界面每一行是一个目录。我们需要在列表里点击“新建”加一行%JAVA_HOME%\bin这里要特别说一下老教程和新界面的区别。以前的 Windows 7/8 时代Path 是一个很长的字符串不同路径用分号分隔所以旧教程里经常写成C:\Program Files\Java\jdk-17\bin;%JAVA_HOME%\bin;...这种混乱格式。Windows 10 之后的 Path 编辑界面变成了多行列表你只需要点“新建”然后粘贴进去一行就好不需要管分号。如果你照着老教程试图在某一行的末尾加分号再追加路径反而容易把原有路径搞坏。配置好之后最好把%JAVA_HOME%\bin这一行“上移”到 Path 列表的顶部。为什么要上移因为 Windows 系统在 Path 列表里查找程序时是从上往下按顺序找的找到第一个名字匹配的java.exe就停止。如果列表靠前位置有其他 Java 相关路径系统就可能会去执行旧版本的 Java而不是你刚装的这个。这里还必须点名一个非常经典的“隐形坑”Oracle 官方安装包在安装过程中会自动往 Path 里添加一个C:\Program Files\Common Files\Oracle\Java\javapath条目。这个目录下放着一个java.exe但它未必带javac.exe。也就是说你配置完环境变量后输入java -version能正常输出版本号让你误以为“配置成功”结果一输javac -version就翻车。这个目录的优先级如果高于%JAVA_HOME%\bin就会造成这种“java 能跑、javac 没有”的经典怪象。处理办法就是要确保%JAVA_HOME%\bin排在javapath上面。3.3 CLASSPATH 到底配不配网上大量老教程会让你新建一个CLASSPATH变量内容写成.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar这行东西在我的电脑里存了很久当初我照着配完一直不知道它有什么用只是感觉不配上心里不踏实。后来才明白这是 JDK 5、JDK 6 时代为了帮助 JVM 找到系统类库而设置的当时的类加载机制依赖这个变量。JDK 9 以后Java 引入了模块化系统同时也调整了类库加载机制dt.jar和tools.jar这两个文件在 JDK 9 及以后的版本里已经不存在了。你再配CLASSPATH指向两个不存在的文件完全没意义。所以我的建议非常明确新配置环境变量时不要配置 CLASSPATH。把环境变量保持在最简单的状态以后遇到问题排查范围越小越容易定位。如果你已经按照以前的教程配了也别着急删删除之后重新打开命令行验证javac和java是否正常一般不会有任何影响。3.4 验证配置三条命令看出门道配置完环境变量后需要打开一个新的命令行窗口来验证。这一步是最容易出问题的环节我单独提一下环境变量的改动不会实时注入到已经打开的窗口里你必须关闭旧的命令行窗口重新打开一个新的 cmd 窗口新改动才会生效。如果你用 PowerShell也是同样的道理。打开方式很简单按Win R输入cmd回车。然后依次输入三条命令java -version javac -version echo %JAVA_HOME%第一条命令如果显示类似java version 17.0.x的内容说明 JDK 自带的运行工具能用了第二条如果显示javac 17.0.x说明编译器也能用了第三条会把你配置的 JAVA_HOME 值打印出来用来确认系统变量是不是读到了。如果java -version正常但echo %JAVA_HOME%是空的说明当前窗口是在你修改环境变量之前打开的重新开一个窗口再试。如果java -version正常javac -version报错就去检查我们刚才说的javapath优先级问题。4. 写个 Demo 跑通“编译-运行”闭环4.1 新建一个最小的 Java 源文件环境变量配好了咱们用一个最经典的 Demo 验证完整流程。在任意目录下新建一个文本文件把文件名改成Demo.java。注意 Windows 的“隐藏已知文件类型的扩展名”选项可能会让你以为文件名就是Demo.java.txt最终导致编译失败。你可以在记事本里查看“文件类型”确认一下或者直接在命令行工具里用dir命令查看目录下的真实文件名。用记事本或者任意编辑器写入以下代码public class Demo { public static void main(String[] args) { System.out.println(Hello, Java on Windows 10!); } }public class Demo这里的类名Demo必须和文件名一致大小写也要一致。这是 Java 的基本规则不一致的话编译器会直接拒绝执行。4.2 用 javac 编译、用 java 运行在资源管理器的地址栏里输入cmd回车就会在这个目录下打开命令行窗口。先输入javac Demo.java回车之后如果没有任何输出没有报错就成功了。此时目录下应该多出一个Demo.class文件这就是编译出来的字节码文件。如果编译报错通常是代码里某个符号写错了比如分号用了中文符号、大括号没闭合这类问题仔细对照代码就能发现。紧接着再输入java Demo这里要特别强调java后面跟的是类名Demo不是文件名Demo.java也不是Demo.class。很多人会在这一步写成java Demo.class结果系统提示“找不到或无法加载主类 Demo.class”。去掉.class后缀再运行一遍就正常了。程序输出Hello, Java on Windows 10!说明下载、安装、环境变量配置、编译、运行这条完整的链路全部打通了。4.3 配置完 IDE 还不认 JDK怎么处理命令行验证通过之后IntelliJ IDEA、Eclipse、VS Code 等开发工具一般都能自动识别系统的 JAVA_HOME 变量。如果你打开 IDEA 后仍然提示找不到 JDK可以手动指定。以 IDEA 为例在欢迎页点Customize进入Project Structure左侧选SDKs然后“添加 JDK”选择你安装的 JDK 根目录即可。大部分情况下只要图标变绿、能创建 Java 项目就说明 ID的 JDK 关联成功了。5. 高频问题与排查技巧实录5.1 配完环境变量命令行窗口还是没反应这是每天都会有人遇到的情况。最常见的原因是你改环境变量之前已经开着一个命令行窗口改完之后直接在这个旧窗口里执行命令。Windows 的环境变量改动不会自动同步到已经启动的进程里旧窗口里保存的还是老的变量快照。解决办法很简单真的把当前所有 cmd、PowerShell 窗口全部关掉重新打开一个干净的窗口再试。要是重开之后echo %JAVA_HOME%仍然输出空再看一眼你配置的位置是不是在“用户变量”里。有些同学在“用户变量”里新建了 JAVA_HOME但当前登录的用户和打开命令行窗口的用户是同一个按理说也能读到。如果实在读不到可以尝试注销重登一下系统。不过登出前最好先确认一下变量名有没有拼写错误比如写成JAVE_HOME这种系统是不会帮你纠正的。5.2 java -version 正常javac 提示“不是内部或外部命令”整个过程里这种现象最让人崩溃。明明验证 java 能跑说明 JDK 已经装了但 javac 就是找不到。这种案例里九成以上是javapath的问题。Oracle 安装器会自动往系统 Path 里塞一个C:\Program Files\Common Files\Oracle\Java\javapath目录这个目录里的确有java.exe有的版本也有javac.exe但它指向的未必是你刚安装的这个 JDK 目录。如果系统按 Path 顺序先找到了javapath里的旧版java.exe就会执行旧版旧版带的javac没注册或者路径不对自然就报错了。排查方法在命令行里输入where java它会输出系统找到的所有java.exe的位置以及先后顺序。如果排在第一位的不是%JAVA_HOME%\bin\java.exe而是 Oracle 的javapath那么问题就清楚了。解决方案去环境变量里把%JAVA_HOME%\bin上移到系统 Path 列表的最顶部。如果你已经不打算用旧版本也可以手动删除javapath那一条但删除前建议先备份原 Path 内容万一还要恢复也有退路。5.3 电脑里装了多个 JDK版本切换总不对开发过程中难免会装多个 JDK 版本比如为了跑老项目装了 JDK 8为了学新框架又装了 JDK 17。切换的时候明明已经把 JAVA_HOME 改成 JDK 17 了但命令行里java -version还是显示 JDK 8。这种情况依然是 Path 的搜索顺序问题。因为 JAVA_HOME 只是一个变量系统执行java命令时并不直接看 JAVA_HOME而是通过 Path 找到真实路径。Path 里可能有多个条目都指向 Java 相关目录比如 IDEA 自带的 JBR 目录、Oracle 的 javapath、旧版本 JDK 的 bin 目录。系统从上往下找找到的第一个java.exe就执行了根本轮不到你新配置的%JAVA_HOME%\bin。所以要想彻底控制版本切换最稳妥的做法是把%JAVA_HOME%\bin固定在 Path 的绝对最上方并且删掉javapath条目。这样每次只修改 JAVA_HOME 指向就能完成版本切换。我个人的习惯是在 D 盘建一个Java目录里面放进jdk-8、jdk-17、jdk-21三个子目录需要切哪个版本就把 JAVA_HOME 改成对应路径再配合一个 BAT 脚本一键切换比每次手动改系统变量省心很多。5.4 安装路径里有中文或空格引发的“玄学”问题我在 2.3 节里建议过用干净路径但肯定有人装的时候没注意默认或自定义了一个带空格或者带中文的目录比如C:\Program Files\Java\jdk-17。这个路径大概率没问题因为 Java 官方自己默认就是装在带空格的目录里但配合某些自动化脚本时空格会导致脚本无法正确解析变量。如果遇到奇怪的报错比如脚本找不到 JAVA_HOME或者某些工具编译时报“找不到文件”错误可以试试把 JAVA_HOME 指向的路径改用短文件名格式。在命令行里输入dir /x C:\Program Files\Java能看到像JDK-17~1这样的短名称。把短名称拼进完整路径例如C:\PROGRA~1\Java\JDK-17~1\bin在个别老工具里往往能救命。当然对于新项目最干净的做法还是从一开始就不用默认路径直接装到D:\Java\jdk-17这种地方。5.5 高频问题速查表现象最可能原因解决方向java -version报错找不到命令Path 里没有配置%JAVA_HOME%\bin把%JAVA_HOME%\bin加入系统变量 Pathecho %JAVA_HOME%为空环境变量没保存或当前窗口未刷新重新打开 cmd检查变量名是否拼错javac -version报错但 java 正常Oraclejavapath优先级高于配置将%JAVA_HOME%\bin上移到 Path 最前面切换 JDK 版本后版本号不变Path 列表里多个 Java 相关路径删除或禁用旧的 Java 路径条目IDE 找不到 JDKIDE 启动时读取 JAVA_HOME 失败在 IDE 的 SDK 设置中手动指定 JDK 根目录编译输出中文乱码源码编码和控制台编码不一致统一使用 UTF-8 保存源码或调整控制台代码页最后分享一个我自己踩过几次坑之后养成的习惯每次改完环境变量一定重新开一个新的 cmd 窗口来验证不用旧窗口验证javac的时候顺手where java、where javac各看一眼确认实际执行的程序确实来自我想用的 JDK 目录。这些小习惯看似麻烦却能在以后的学习和项目开发里替你省下很多莫名其妙的排查时间。配置这件事一次理顺后面就畅通了。
先说你最可能遇到的情况照着网上的教程一步步操作到了最后验证环境变量的那一步打开命令行输入java -version版本号能出来心里刚要松口气结果再输javac -version直接给你来一句“不是内部或外部命令”。我当年第一次配 JDK 的时候就卡在这个莫名其妙的地方后来把环境变量翻来覆去检查了好几遍才发现问题出在安装时 Oracle 自动写入 Path 的一个路径上。这篇教程就沿着 Windows 10 上 JDK 下载、安装、配置的完整流程走一遍。我会把每一步操作背后的原理也讲清楚不是为了凑字数而是因为很多坑都是因为你只知道“怎么做”、不知道“为什么这么做”才踩进去的。这篇内容适合刚入门 Java、准备搭开发环境的新手也适合之前配过但从没完全搞懂、想一次性把环境变量这件事彻底弄明白的同学。1. 先弄清楚 JDK、JRE 和环境变量到底在干什么1.1 JDK 和 JRE别把两个“J”开头的搞混很多新手一上来就看下载页面发现又是 JDK 又是 JRE直接懵了。简单说JDK 是 Java Development Kit是“开发工具包”里面装着编译器javac、运行工具java、打包工具jar、文档生成工具javadoc这些开发时要用到的东西。JRE 是 Java Runtime Environment是“运行环境”只负责把编译好的 Java 程序跑起来里面没有编译器。打个比方JDK 是一整套厨房锅碗瓢盆、食材加工设备都有你写菜谱、做菜都得靠它JRE 是微波炉你只需要把做好的菜热一热吃掉。所以如果你想自己写 Java 代码、把它编译成可运行程序必须装 JDK。好消息是现在 JDK 安装包里已经自带了运行环境装了 JDK 就足够不用单独再装 JRE。安装完之后你会在 JDK 安装目录下看到bin文件夹里面躺着java.exe和javac.exe这两个核心程序。javac负责把.java源码编译成.class字节码java负责启动虚拟机执行这个字节码。后面我们配置环境变量所有操作都是为了让系统能找到这两个文件。1.2 环境变量是个什么东西为什么非配不可Windows 系统在执行你输入的命令时并不是全盘搜索这个程序藏在哪里而是按顺序查找一个叫 Path 的环境变量里列出的目录。如果你在命令行里输入javac然后回车系统会在“当前目录”和“Path 中记录的所有目录”里找有没有叫这个名字的.exe文件。找不到就会提示“不是内部或外部命令也不是可运行的程序或批处理文件”。也就是说如果不把 JDK 的bin目录加进 Path那系统根本不知道你在说什么。这不是 JDK 没装好而是你装了工具却没告诉系统“工具放在哪个位置”。而JAVA_HOME这个变量又是另一层用途。像 IntelliJ IDEA、Eclipse、Maven、Tomcat 这类软件启动时会主动通过JAVA_HOME去定位 JDK 的安装根目录。比如 Maven 启动脚本里会用%JAVA_HOME%\bin\java这种写法来调用 Java。所以配置JAVA_HOME本质上是给这些主流开发工具提供一个统一入口。这样做还有一个好处以后你想升级 JDK 版本只需要把JAVA_HOME的值改成新版本的安装路径Path 里那一句%JAVA_HOME%\bin完全不用动。这也是所有教程都推荐配置 JAVA_HOME而不是直接把C:\Program Files\Java\jdk-17\bin写死到 Path 里的原因。1.3 该装哪个版本JDK 8、11、17 还是 21版本选择是个老生常谈的话题也是评论区最容易吵起来的话题。我说下自己的建议你按实际场景选就行。版本类型适合场景JDK 8经典老版本很多旧项目、老框架还在用企业存量极大JDK 11长期支持版本介于中间的一个过渡版本有些框架兼容性需要调整JDK 17长期支持版本目前最主流的新项目选择Spring Boot 3 依赖 17 及以上JDK 21长期支持版本较新的长期支持版本想尝鲜可以用我个人建议如果是刚学 Java、没有任何历史包袱直接装 JDK 17 或 JDK 21。原因很简单新版本对 Java 语言特性的支持更完整学习周期内不会遇到“代码写法没问题但编译器版本太旧不支持”这种破事。如果你接下来要学 Spring Boot那就更要选 JDK 17 起步因为新版的 Spring Boot 要求就是 17 起步。如果只是临时跑一个老项目再考虑 JDK 8。这里补充一句关于 OpenJDK 的闲话。Oracle JDK 之外有很多免费可用的 OpenJDK 构建版本比如 Eclipse Temurin、Adoptium 等两者在命令行使用、环境变量配置上没有区别。教程里我以 Oracle JDK 为例讲解操作完全适用于其他发行版。2. 下载 JDK版本、渠道和易踩的坑2.1 下载前先确认系统是 64 位还是 32 位Windows 10 现在绝大多数都是 64 位系统但保不齐有些老电脑还在用 32 位。区别方法很简单右键“此电脑”选“属性”在“系统类型”一栏能看到。如果是 64 位系统下载Windows x64 Installer文件后缀一般是.exe体积大约 150MB 到 200MB。如果是 32 位系统需要下载 x86 版本但说实话32 位的 JDK 新版本基本已经停止提供这种机器最好的出路还是重装成 64 位系统。还要注意别手滑下载成.tar.gz或.zip压缩包。压缩包版本也能用配置环境变量的思路也一样只是对于新手来说.exe安装程序的下一步下一步操作更友好。我建议一律用Windows x64 Installer。2.2 官方下载页和国内镜像怎么选优先去 Oracle 官网下载。这里有个小坑Oracle 官网首页往往让你先看到甲骨文的数据库、云服务产品Java 下载还得自己找入口。你可以在搜索框搜Java SE Downloads或者直接访问 Oracle 的 Java Downloads 页面。在下载列表里你要找的是“Windows x64 Installer”那一行。点进去之后有些页面会先让你勾选 “I reviewed and accept the Oracle Technology Network License Agreement”勾好之后按钮才会变成可点击状态。有同学反映明明点了下载却一直不动大概率是这一步没操作。国内网络环境下从官网下载偶尔会很慢甚至下载到一半断掉。这时候可以用国内知名镜像站下载。例如部分高校开源软件镜像站、云厂商的镜像站里都有 JDK 的镜像副本速度稳定很多。下完之后校验一下文件大小是否和官网标称一致再继续安装。有杀毒软件的朋友可能会被提示安装包被拦截一般是因为安装包需要写入系统目录属于正常行为添加信任后放行即可。2.3 安装时路径怎么选最省心双击安装包之后很快就到选择安装路径这一步。有些同学喜欢全部用默认路径即C:\Program Files\Java\jdk-17这没问题有些同学喜欢把开发工具统一放在 D 盘比如D:\Java\jdk-17这也很好。但有一条硬性建议安装路径里别带中文也别出现空格和特殊符号。虽然 Java 本身对带空格的路径兼容性已经不错但后续配合 Maven、Tomcat、IDEA 使用时某些老旧的脚本和插件在解析路径时会出现意想不到的问题。所以如果你想改路径建议改成类似D:\Java\jdk-17这样简短干净的目录。安装过程中安装程序可能会问你要不要安装“公共 JRE”Public JRE如果你看到这个勾选项不勾选也是可以的。因为 JDK 内部已经自带一套完整的运行环境公共 JRE 只是额外安装到另一个目录对开发来说不是必需品。保持最小化安装后续排查问题也方便。3. Windows 10 上的安装与环境变量配置实操3.1 一步一步配置 JAVA_HOME安装完成之后我们要进入重头戏。右键“此电脑”选择“属性”再点左侧的“高级系统设置”会弹出“系统属性”窗口点击右下方的“环境变量”按钮。这里要注意界面里分成上下两个区域上面是“用户变量”下面是“系统变量”。我们要操作的是下面的“系统变量”区域尽量别配到用户变量里。点击“系统变量”下方的“新建”按钮变量名填JAVA_HOME变量值填你 JDK 的实际安装根目录。比如我装的是 JDK 17默认路径是C:\Program Files\Java\jdk-17那变量值就填这一行。注意两点一是不要再往后面加bin二是结尾不要加分号。这里填的是根目录javac等程序是在根目录下的bin子目录里。为什么推荐配系统变量而不是用户变量因为有些开发工具和命令是在不同用户账户下运行的配到系统变量里所有用户、所有服务都能读到省去很多权限层面的奇怪问题。3.2 修改 Path让系统能找到 javac还是在“系统变量”列表里找到Path双击它Windows 10 会弹出一个按行展示的编辑界面每一行是一个目录。我们需要在列表里点击“新建”加一行%JAVA_HOME%\bin这里要特别说一下老教程和新界面的区别。以前的 Windows 7/8 时代Path 是一个很长的字符串不同路径用分号分隔所以旧教程里经常写成C:\Program Files\Java\jdk-17\bin;%JAVA_HOME%\bin;...这种混乱格式。Windows 10 之后的 Path 编辑界面变成了多行列表你只需要点“新建”然后粘贴进去一行就好不需要管分号。如果你照着老教程试图在某一行的末尾加分号再追加路径反而容易把原有路径搞坏。配置好之后最好把%JAVA_HOME%\bin这一行“上移”到 Path 列表的顶部。为什么要上移因为 Windows 系统在 Path 列表里查找程序时是从上往下按顺序找的找到第一个名字匹配的java.exe就停止。如果列表靠前位置有其他 Java 相关路径系统就可能会去执行旧版本的 Java而不是你刚装的这个。这里还必须点名一个非常经典的“隐形坑”Oracle 官方安装包在安装过程中会自动往 Path 里添加一个C:\Program Files\Common Files\Oracle\Java\javapath条目。这个目录下放着一个java.exe但它未必带javac.exe。也就是说你配置完环境变量后输入java -version能正常输出版本号让你误以为“配置成功”结果一输javac -version就翻车。这个目录的优先级如果高于%JAVA_HOME%\bin就会造成这种“java 能跑、javac 没有”的经典怪象。处理办法就是要确保%JAVA_HOME%\bin排在javapath上面。3.3 CLASSPATH 到底配不配网上大量老教程会让你新建一个CLASSPATH变量内容写成.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar这行东西在我的电脑里存了很久当初我照着配完一直不知道它有什么用只是感觉不配上心里不踏实。后来才明白这是 JDK 5、JDK 6 时代为了帮助 JVM 找到系统类库而设置的当时的类加载机制依赖这个变量。JDK 9 以后Java 引入了模块化系统同时也调整了类库加载机制dt.jar和tools.jar这两个文件在 JDK 9 及以后的版本里已经不存在了。你再配CLASSPATH指向两个不存在的文件完全没意义。所以我的建议非常明确新配置环境变量时不要配置 CLASSPATH。把环境变量保持在最简单的状态以后遇到问题排查范围越小越容易定位。如果你已经按照以前的教程配了也别着急删删除之后重新打开命令行验证javac和java是否正常一般不会有任何影响。3.4 验证配置三条命令看出门道配置完环境变量后需要打开一个新的命令行窗口来验证。这一步是最容易出问题的环节我单独提一下环境变量的改动不会实时注入到已经打开的窗口里你必须关闭旧的命令行窗口重新打开一个新的 cmd 窗口新改动才会生效。如果你用 PowerShell也是同样的道理。打开方式很简单按Win R输入cmd回车。然后依次输入三条命令java -version javac -version echo %JAVA_HOME%第一条命令如果显示类似java version 17.0.x的内容说明 JDK 自带的运行工具能用了第二条如果显示javac 17.0.x说明编译器也能用了第三条会把你配置的 JAVA_HOME 值打印出来用来确认系统变量是不是读到了。如果java -version正常但echo %JAVA_HOME%是空的说明当前窗口是在你修改环境变量之前打开的重新开一个窗口再试。如果java -version正常javac -version报错就去检查我们刚才说的javapath优先级问题。4. 写个 Demo 跑通“编译-运行”闭环4.1 新建一个最小的 Java 源文件环境变量配好了咱们用一个最经典的 Demo 验证完整流程。在任意目录下新建一个文本文件把文件名改成Demo.java。注意 Windows 的“隐藏已知文件类型的扩展名”选项可能会让你以为文件名就是Demo.java.txt最终导致编译失败。你可以在记事本里查看“文件类型”确认一下或者直接在命令行工具里用dir命令查看目录下的真实文件名。用记事本或者任意编辑器写入以下代码public class Demo { public static void main(String[] args) { System.out.println(Hello, Java on Windows 10!); } }public class Demo这里的类名Demo必须和文件名一致大小写也要一致。这是 Java 的基本规则不一致的话编译器会直接拒绝执行。4.2 用 javac 编译、用 java 运行在资源管理器的地址栏里输入cmd回车就会在这个目录下打开命令行窗口。先输入javac Demo.java回车之后如果没有任何输出没有报错就成功了。此时目录下应该多出一个Demo.class文件这就是编译出来的字节码文件。如果编译报错通常是代码里某个符号写错了比如分号用了中文符号、大括号没闭合这类问题仔细对照代码就能发现。紧接着再输入java Demo这里要特别强调java后面跟的是类名Demo不是文件名Demo.java也不是Demo.class。很多人会在这一步写成java Demo.class结果系统提示“找不到或无法加载主类 Demo.class”。去掉.class后缀再运行一遍就正常了。程序输出Hello, Java on Windows 10!说明下载、安装、环境变量配置、编译、运行这条完整的链路全部打通了。4.3 配置完 IDE 还不认 JDK怎么处理命令行验证通过之后IntelliJ IDEA、Eclipse、VS Code 等开发工具一般都能自动识别系统的 JAVA_HOME 变量。如果你打开 IDEA 后仍然提示找不到 JDK可以手动指定。以 IDEA 为例在欢迎页点Customize进入Project Structure左侧选SDKs然后“添加 JDK”选择你安装的 JDK 根目录即可。大部分情况下只要图标变绿、能创建 Java 项目就说明 ID的 JDK 关联成功了。5. 高频问题与排查技巧实录5.1 配完环境变量命令行窗口还是没反应这是每天都会有人遇到的情况。最常见的原因是你改环境变量之前已经开着一个命令行窗口改完之后直接在这个旧窗口里执行命令。Windows 的环境变量改动不会自动同步到已经启动的进程里旧窗口里保存的还是老的变量快照。解决办法很简单真的把当前所有 cmd、PowerShell 窗口全部关掉重新打开一个干净的窗口再试。要是重开之后echo %JAVA_HOME%仍然输出空再看一眼你配置的位置是不是在“用户变量”里。有些同学在“用户变量”里新建了 JAVA_HOME但当前登录的用户和打开命令行窗口的用户是同一个按理说也能读到。如果实在读不到可以尝试注销重登一下系统。不过登出前最好先确认一下变量名有没有拼写错误比如写成JAVE_HOME这种系统是不会帮你纠正的。5.2 java -version 正常javac 提示“不是内部或外部命令”整个过程里这种现象最让人崩溃。明明验证 java 能跑说明 JDK 已经装了但 javac 就是找不到。这种案例里九成以上是javapath的问题。Oracle 安装器会自动往系统 Path 里塞一个C:\Program Files\Common Files\Oracle\Java\javapath目录这个目录里的确有java.exe有的版本也有javac.exe但它指向的未必是你刚安装的这个 JDK 目录。如果系统按 Path 顺序先找到了javapath里的旧版java.exe就会执行旧版旧版带的javac没注册或者路径不对自然就报错了。排查方法在命令行里输入where java它会输出系统找到的所有java.exe的位置以及先后顺序。如果排在第一位的不是%JAVA_HOME%\bin\java.exe而是 Oracle 的javapath那么问题就清楚了。解决方案去环境变量里把%JAVA_HOME%\bin上移到系统 Path 列表的最顶部。如果你已经不打算用旧版本也可以手动删除javapath那一条但删除前建议先备份原 Path 内容万一还要恢复也有退路。5.3 电脑里装了多个 JDK版本切换总不对开发过程中难免会装多个 JDK 版本比如为了跑老项目装了 JDK 8为了学新框架又装了 JDK 17。切换的时候明明已经把 JAVA_HOME 改成 JDK 17 了但命令行里java -version还是显示 JDK 8。这种情况依然是 Path 的搜索顺序问题。因为 JAVA_HOME 只是一个变量系统执行java命令时并不直接看 JAVA_HOME而是通过 Path 找到真实路径。Path 里可能有多个条目都指向 Java 相关目录比如 IDEA 自带的 JBR 目录、Oracle 的 javapath、旧版本 JDK 的 bin 目录。系统从上往下找找到的第一个java.exe就执行了根本轮不到你新配置的%JAVA_HOME%\bin。所以要想彻底控制版本切换最稳妥的做法是把%JAVA_HOME%\bin固定在 Path 的绝对最上方并且删掉javapath条目。这样每次只修改 JAVA_HOME 指向就能完成版本切换。我个人的习惯是在 D 盘建一个Java目录里面放进jdk-8、jdk-17、jdk-21三个子目录需要切哪个版本就把 JAVA_HOME 改成对应路径再配合一个 BAT 脚本一键切换比每次手动改系统变量省心很多。5.4 安装路径里有中文或空格引发的“玄学”问题我在 2.3 节里建议过用干净路径但肯定有人装的时候没注意默认或自定义了一个带空格或者带中文的目录比如C:\Program Files\Java\jdk-17。这个路径大概率没问题因为 Java 官方自己默认就是装在带空格的目录里但配合某些自动化脚本时空格会导致脚本无法正确解析变量。如果遇到奇怪的报错比如脚本找不到 JAVA_HOME或者某些工具编译时报“找不到文件”错误可以试试把 JAVA_HOME 指向的路径改用短文件名格式。在命令行里输入dir /x C:\Program Files\Java能看到像JDK-17~1这样的短名称。把短名称拼进完整路径例如C:\PROGRA~1\Java\JDK-17~1\bin在个别老工具里往往能救命。当然对于新项目最干净的做法还是从一开始就不用默认路径直接装到D:\Java\jdk-17这种地方。5.5 高频问题速查表现象最可能原因解决方向java -version报错找不到命令Path 里没有配置%JAVA_HOME%\bin把%JAVA_HOME%\bin加入系统变量 Pathecho %JAVA_HOME%为空环境变量没保存或当前窗口未刷新重新打开 cmd检查变量名是否拼错javac -version报错但 java 正常Oraclejavapath优先级高于配置将%JAVA_HOME%\bin上移到 Path 最前面切换 JDK 版本后版本号不变Path 列表里多个 Java 相关路径删除或禁用旧的 Java 路径条目IDE 找不到 JDKIDE 启动时读取 JAVA_HOME 失败在 IDE 的 SDK 设置中手动指定 JDK 根目录编译输出中文乱码源码编码和控制台编码不一致统一使用 UTF-8 保存源码或调整控制台代码页最后分享一个我自己踩过几次坑之后养成的习惯每次改完环境变量一定重新开一个新的 cmd 窗口来验证不用旧窗口验证javac的时候顺手where java、where javac各看一眼确认实际执行的程序确实来自我想用的 JDK 目录。这些小习惯看似麻烦却能在以后的学习和项目开发里替你省下很多莫名其妙的排查时间。配置这件事一次理顺后面就畅通了。
