搭建Java开发环境的第一步就是安装JDK，但很多新手在安装完成之后发现命令行里执行java -version仍然报错，提示不是内部或外部命令，问题就出在环境变量没有配置或者配置有误。环境变量相当于告诉操作系统去哪里找Java的可执行程序，配置好之后无论在哪个目录下都能直接使用java、javac这些命令。下面以Windows系统为主，详细介绍配置的完整过程，并附上macOS和Linux系统的处理方式。
一、安装JDK并确认安装目录
配置环境变量之前，首先要确认JDK已经正确安装，并且知道它装在哪个目录。安装JDK时建议不要使用默认的、带有空格或者中文的路径，比如Program Files这种目录虽然能用，但在某些脚本场景下容易出问题。可以选择一个简洁的路径，例如C:\Java\jdk-17，安装过程中记下这个路径，后面配置环境变量要用。
安装完成后可以先去安装目录确认一下文件结构。打开该目录，应该能看到bin、lib、conf等文件夹，其中bin目录下就有java.exe和javac.exe这两个最核心的可执行文件。如果找不到这些文件，说明JDK本身没有安装成功，需要重新安装。验证方法很简单，直接双击进入bin目录，在地址栏输入cmd回车打开命令行，执行java -version，如果能输出版本信息，说明JDK文件是完整的，接下来只需要配置环境变量让系统全局识别即可。
二、Windows系统下配置三个核心环境变量
Windows下需要配置的环境变量主要有三个：JAVA_HOME、Path和ClassPath。在Windows 10或Windows 11中，右键点击此电脑选择属性，进入高级系统设置，点击环境变量按钮，就会看到上下两个区域，上面是当前用户变量，下面是系统变量。建议直接在系统变量区域配置，这样所有用户都能生效。
第一步配置JAVA_HOME。点击系统变量下方的新建按钮，变量名填JAVA_HOME，变量值填JDK的安装目录，例如C:\Java\jdk-17。注意这里填的是JDK根目录，不要带bin，也不要带末尾的分号。这个变量的作用是定义JDK的安装位置，后续很多工具比如Tomcat、Maven、IDEA都会读取这个变量来定位JDK。
第二步配置Path。在系统变量列表中找到Path，选中后点击编辑，再点新建，填入%JAVA_HOME%\bin。使用变量引用的好处是以后更换JDK版本时只需要修改JAVA_HOME的值，Path不用动。这里强烈建议把这一条通过上移按钮移到列表靠前的位置，避免被系统里其他自带的Java运行时抢先匹配，导致版本对不上的诡异问题。
第三步配置ClassPath。老版本的JDK需要配置这个变量，值为.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar，开头那个点代表当前目录。不过从JDK 5之后，这个变量基本可以不配置，JVM会自动处理类路径，现代开发中通常省略这一步，这里说明一下只是为了让读者理解历史遗留写法。
三、验证配置是否成功
配置完成后需要验证。打开命令行窗口，注意必须是重新打开的新窗口，因为已经打开的窗口不会读取到刚修改的环境变量。执行下面的命令：
java -version javac -version echo %JAVA_HOME%
如果java -version和javac -version都能正常输出版本号，且两者的版本一致，说明Path配置成功。如果java能执行但javac不行，多半是系统里装了单独的JRE，或者Path指向的目录不对。可以执行where java命令查看系统实际调用的是哪个路径下的java程序，如果显示的不是你配置的JDK目录，就需要去调整Path中的顺序。
版本一致这一点很重要。有些教程只检查java命令，结果编译时用的javac是17版本，运行时用的却是系统自带的8版本，出现不支持的类文件版本这类错误时就很难排查。养成同时检查两个命令的习惯，能省去不少麻烦。
四、macOS和Linux系统下的配置方法
macOS和Linux系统不使用图形化的环境变量界面，而是通过修改shell配置文件实现。先确认JDK安装位置，macOS下可以在终端执行/usr/libexec/java_home查看默认JDK路径，Linux下如果通过包管理器安装，一般位于/usr/lib/jvm/目录下。
以macOS的zsh为例，编辑用户目录下的.zshrc文件，在末尾追加以下内容：
export JAVA_HOME=$(/usr/libexec/java_home) export PATH=$JAVA_HOME/bin:$PATH
保存后执行source ~/.zshrc让配置立即生效，然后运行java -version验证。Linux系统如果使用bash，则编辑.bashrc或.bash_profile文件，写法相同。这里的技巧是先定义JAVA_HOME再引用它拼接Path，和Windows下的思路完全一致，只是语法不同。
五、常见问题排查
配置过程中最常见的问题有几种。第一种是变量值里多写了bin，比如把JAVA_HOME配成了C:\Java\jdk-17\bin，这样Path里的%JAVA_HOME%\bin就会变成寻找bin\bin目录，自然找不到程序。第二种是Windows下多个路径之间漏了分号分隔符，或者误用了中文全角分号。第三种是修改完环境变量没有重开命令行窗口，旧窗口读不到新配置，误以为配置失败。
还有一种情况是多个JDK版本共存导致冲突。可以用where java和where javac分别查看系统实际调用的程序位置，Windows会按照Path中的顺序查找，排在前面的优先。解决方法是把想要使用的版本的bin目录调整到Path列表最前面，或者删掉不需要的旧版本条目。如果IDE里的JDK和命令行的不一致，还要检查IDE的项目设置，IDEA和Eclipse都可以在项目结构中单独指定JDK，不受系统环境变量约束，这一点在做版本切换时要特别留意。
Java环境变量配置JDK安装JAVA_HOME修改时间：2026-09-10 04:06:29