对于刚接触Java编程的新手来说，JDK环境配置是入门的第一步，也是最容易踩坑的环节。很多新手下载完JDK后，因为环境变量配置不当，导致cmd命令行输入java、javac提示“不是内部或外部命令”，白白浪费时间。今天这篇入门教程，专门针对Windows系统（Win10/Win11通用），全程图文式步骤，避开所有新手常见坑，哪怕是零基础小白，跟着做也能一次配置成功。
先跟大家说下核心重点：JDK配置的核心是设置3个环境变量（其中1个可选），关键是记住JDK安装路径，路径里不能有中文、空格，配置完一定要新开cmd验证，这3点做好，基本不会出错。
一、前置准备：下载并安装JDK（新手必看）
配置前必须先安装JDK，这里给新手推荐两个最稳妥的版本和下载渠道，避免大家下错版本、下到捆绑软件。
1. JDK版本选择（新手优先选这两个）
新手不用纠结最新版本，优先选长期支持版（LTS），稳定性强、兼容性好，后续学习、做项目都不会出问题，推荐两个版本：
-
JDK 8：老牌长期支持版，兼容性最好，很多企业项目还在使用，适合新手入门、维护旧项目，学习资料也最多；
-
JDK 24：当前最新主流长期支持版，支持很多新特性，适合想学习新内容、做新项目的新手，Spring Boot 3.x等框架也需要这个版本支持。
两个版本配置方法完全一样，大家根据自己的需求选择即可，本文以JDK 17为例，JDK 8配置步骤完全通用。
2. 下载渠道（安全无捆绑，新手首选）
很多新手会去官网下载，遇到需要注册Oracle账号的问题，这里给大家推荐便捷的渠道，无需注册，直接下载：
JDK-24.0.1下载安装：juejin.cn/post/762291…
3. JDK安装步骤（重点：记住安装路径）
安装过程很简单，重点是记住安装路径，后续配置环境变量必须用到，新手强烈建议自定义安装路径，避开中文和空格。
-
双击下载好的.msi安装包（如果是.zip格式，直接解压即可），启动安装向导，点击“下一步”；
-
建议点击“更改”，自定义安装路径，比如“D:\Java\jdk-17.0.10”（路径中不要有“中文”“空格”，比如不要装在“Program Files”文件夹，也不要装在桌面）；
-
继续点击“下一步”，直到安装完成，安装过程中会提示安装JRE（Java运行环境），无需额外操作，默认跟随JDK安装即可；
-
安装完成后，打开你设置的安装路径，确认里面有“bin”“lib”等文件夹，记住这个完整路径（比如D:\Java\jdk-17.0.10），后面要用到。
温馨提示：如果不小心忘记了安装路径，可右键“此电脑”→“管理”→“设备管理器”→“软件组件”，找到对应JDK版本，查看安装位置；或者直接在电脑搜索“jdk”，找到安装文件夹，复制完整路径。
二、核心步骤：Windows JDK环境变量配置（新手零踩坑）
环境变量配置是JDK生效的关键，很多新手配置失败，都是因为这一步出错。全程跟着步骤来，每一步都有详细说明，不用怕记不住。
第一步：打开环境变量设置（两种方法，任选一种）
方法一（传统方法，Win10/Win11通用）：
-
右键桌面“此电脑”，选择“属性”；
-
在弹出的窗口中，找到“高级系统设置”，点击进入；
-
在“系统属性”窗口中，点击右下角的“环境变量”，进入配置界面。
方法二（快捷方法，Win10/Win11通用）：
按Win+R键，输入“sysdm.cpl”，回车，直接打开“系统属性”窗口，再点击“环境变量”即可，比方法一更快捷。
注意：我们后续所有操作，都在“系统变量”中进行，不要修改“用户变量”（用户变量只对当前登录账户生效，系统变量对所有账户生效，更适合新手）。
第二步：配置JAVA_HOME变量（核心，必配）
JAVA_HOME变量是很多Java相关工具（比如Maven、Tomcat、IDEA）识别JDK位置的关键，必须配置正确，步骤如下：
-
在“系统变量”区域，点击“新建”按钮；
-
弹出“新建系统变量”窗口，变量名输入：JAVA_HOME（注意大写，不能写错，写错会导致配置失败）；
-
变量值输入：你刚才记住的JDK安装完整路径（比如D:\Java\jdk-17.0.10），输入时不要加空格、不要加引号，直接复制路径粘贴即可；
-
点击“确定”，保存这个变量，JAVA_HOME配置完成。
第三步：配置Path变量（最重要，必配）
Path变量的作用是让系统在任意位置都能识别java、javac等JDK命令，这一步是新手最容易出错的地方，重点注意路径顺序。
-
在“系统变量”中，找到“Path”变量（系统自带，无需新建），双击“Path”进入编辑界面；
-
在编辑界面中，点击“新建”，输入：%JAVA_HOME%\bin（注意百分号是英文状态，不要输错，这个路径是自动关联JAVA_HOME的bin目录，后续如果更换JDK版本，只需修改JAVA_HOME即可，无需再改Path）；
-
（关键一步）选中刚添加的“%JAVA_HOME%\bin”，点击“上移”按钮，将其移到Path列表的最顶部，避免系统自带的Java环境（如果有的话）覆盖我们配置的JDK；
-
点击“确定”，保存Path变量的修改。
第四步：配置CLASSPATH变量（可选，新手可省略）
很多老教程会让配置CLASSPATH，但从JDK 1.5版本开始，JVM会自动扫描当前目录下的class文件和依赖包，新手可以不用手动配置，配置不当反而会引发问题。
如果是学习老项目、需要用到JDK 1.4及以下版本，可按以下步骤配置：
-
在“系统变量”中，点击“新建”；
-
变量名输入：CLASSPATH；
-
变量值输入：.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar（开头的英文句号“.”不能丢，代表当前目录，是加载本地class文件的关键）；
-
点击“确定”保存即可。
第五步：保存所有配置
所有变量配置完成后，依次点击所有弹出窗口的“确定”按钮，不要直接关闭窗口，否则配置不会生效。
三、验证配置：确认是否成功（新手必做）
配置完成后，一定要验证是否成功，很多新手忘记新开cmd窗口，导致验证失败，误以为配置错了，这一步重点注意。
-
按Win+R键，输入“cmd”，打开命令提示符窗口（注意：必须新开cmd窗口，之前打开的窗口不会加载新配置）；
-
在cmd窗口中，输入第一个命令：java -version（注意java和“-version”之间有一个空格），回车；
-
再输入第二个命令：javac -version（同样，javac和“-version”之间有一个空格），回车；
-
如果两个命令都能显示对应的JDK版本号（比如java version "17.0.10"），说明配置成功；如果提示“不是内部或外部命令”，说明配置有问题，回到前面步骤检查。
额外验证（可选）：输入“echo %JAVA_HOME%”，回车，如果显示你配置的JDK安装路径，说明JAVA_HOME变量配置正确。
四、新手常见问题排查（避坑必看）
整理了新手配置JDK时最常遇到的4个问题，每个问题都有对应的解决方法，遇到报错直接对照排查，不用盲目找教程。
问题1：cmd输入java、javac提示“不是内部或外部命令”
最常见的问题，解决方法按优先级排序：
-
检查Path变量中是否添加了“%JAVA_HOME%\bin”，且是否移到了最顶部；
-
检查JAVA_HOME的路径是否正确，有没有输错、多输空格，或者路径中包含中文、空格；
-
确认是否新开了cmd窗口，旧窗口不会加载新的环境变量配置；
-
如果还是不行，重启电脑，让环境变量完全生效。
问题2：输出版本号和安装的JDK版本不一致
原因：系统中存在多个JDK版本，Path变量中旧版本的路径优先级更高。
解决方法：打开Path变量编辑界面，将“%JAVA_HOME%\bin”移到最顶部，删除Path中其他与Java相关的路径（比如旧JDK的bin路径、系统自带的Java路径），然后新开cmd验证。
问题3：能执行java命令，不能执行javac命令
原因：安装的是JRE（只能运行Java程序，不能编译），而不是JDK；或者JAVA_HOME路径指向了JRE的安装目录。
解决方法：重新下载JDK（确认文件名包含“jdk”，不是“jre”），重新安装，然后修改JAVA_HOME路径，指向新安装的JDK根目录，再验证。
问题4：配置后重启电脑，验证还是失败
原因：修改环境变量时没有管理员权限，导致配置不持久；或者路径中存在特殊字符。
解决方法：右键点击“此电脑”→“属性”→“高级系统设置”→“环境变量”，重新检查所有配置，确保路径正确；如果是企业版Windows，用管理员身份运行cmd，重新配置环境变量即可。
五、新手补充说明（实用技巧）
-
如果后续需要更换JDK版本，无需重新配置Path，只需修改JAVA_HOME的变量值，改为新的JDK安装路径，新开cmd验证即可；
-
新手建议将JDK安装路径记在记事本上，后续安装IDEA、Eclipse等开发工具时，需要选择JDK路径；
-
下载JDK时，尽量选择.msi安装包，比.zip压缩包更方便，无需手动解压配置；
-
如果觉得配置麻烦，也可以用IDE（比如IDEA）直接下载JDK，IDE会自动配置环境变量，适合完全不想手动配置的新手。
