在Java中如何安装JDK并配置环境变量

来源:苹果APP网作者:下班再修头衔:程序员
导读:本期聚焦于下班再修创作的《在Java中如何安装JDK并配置环境变量》,敬请观看详情。很多刚接触Java开发的新手不知道如何搭建基础开发环境,首先需要完成JDK的安装,之后还要正确配置对应的环境变量才能让Java程序正常运行。本文会详细介绍不同操作系统下JDK的安装步骤,以及环境变量的具体配置方法,同时会说明配置完成后如何验证是否生效。整个流程操作简单,按照步骤执行就能快速完成Java开发环境的搭建,避免后续开发过程中出现环境相关的报错问题。

Java开发的第一步是安装JDK并配置对应的环境变量,只有完成这些基础操作,才能正常编译和运行Java程序。不同操作系统的安装和配置流程存在差异,下面分别介绍Windows、macOS和Linux系统下的具体操作步骤。

在Java中如何安装JDK并配置环境变量

Java入门第一步:JDK安装与环境变量配置完全指南

一、为什么必须先安装JDK并配置环境变量?

在学习Java编程之前,首先要理解一个基本概念:Java是一门编译型+解释型的语言。我们编写的.java源文件需要通过JDK提供的javac编译器编译成字节码文件(.class),然后再通过JVM(Java虚拟机)解释执行。JDK(Java Development Kit)就是Java开发工具包,它包含了编译器、运行时环境(JRE)、调试工具等一系列开发必备组件。

很多初学者会遇到这样的困惑:明明下载了JDK并完成了安装,但在命令行输入java -version却提示“不是内部或外部命令”。这是因为操作系统不知道去哪里找java.exejavac.exe这两个可执行文件。环境变量的作用就是告诉系统,这些工具的存放路径在哪里。只有正确配置了环境变量,才能在任意目录下直接使用Java命令。

此外,配置JAVA_HOME变量也是一个行业惯例。许多Java应用服务器(如Tomcat、Jetty)以及构建工具(如Maven、Gradle)都会自动读取JAVA_HOME来定位JDK。所以,即便只是为了学习,也建议从一开始就养成良好的配置习惯。

二、Windows系统下的安装与配置

2.1 下载并安装JDK

首先,访问Oracle官方网站的Java SE下载页面,选择适合Windows系统的JDK版本。目前主流版本是JDK 17 LTS(长期支持版)或JDK 21。注意区分操作系统位数:64位系统应下载x64版本,32位系统则选择x86版本。

下载完成后,双击安装包启动安装向导。安装过程中可以选择安装路径,强烈建议使用纯英文路径,例如D:\Java\jdk-17,避免使用包含中文、空格或特殊字符的文件夹名称。因为某些工具在处理带中文的路径时可能出现乱码或找不到文件的情况。一路点击“下一步”即可完成安装,安装程序会自动将JRE一同安装到JDK目录下。

2.2 配置JAVA_HOME变量

安装完成后,需要手动配置环境变量。右键点击桌面上的“此电脑”图标,选择“属性”,然后在左侧点击“高级系统设置”,在弹出的对话框中点击“环境变量”按钮。

在“系统变量”区域点击“新建”,变量名输入JAVA_HOME,变量值输入JDK的实际安装路径,例如D:\Java\jdk-17。点击“确定”保存。为什么要专门设置一个JAVA_HOME变量呢?因为后续配置Path时,如果直接写死路径,将来升级JDK版本时就要逐个修改所有相关配置。而通过%JAVA_HOME%引用,只需修改JAVA_HOME这一个变量即可,非常方便。

2.3 配置Path变量

找到系统变量中的Path变量,双击或点击“编辑”。在打开的编辑窗口中,点击“新建”,然后输入%JAVA_HOME%\bin。注意:bin目录下存放的就是java.exejavac.exe等可执行文件。对于Windows 10及以上版本,使用“新建”按钮添加一行即可;如果是较老的系统,需要在变量值的末尾添加;%JAVA_HOME%\bin(分号用于分隔多个路径)。

配置完成后,连续点击“确定”关闭所有对话框。此时环境变量尚未生效,需要重新打开命令提示符窗口,或者重启电脑。

2.4 验证配置是否成功

按下Win + R组合键,输入cmd并回车,打开命令提示符。依次输入以下两条命令:

java -version
javac -version

如果屏幕上显示出JDK的版本号(例如java version "17.0.9"javac 17.0.9),说明配置成功。如果提示“'java' 不是内部或外部命令”,请检查JAVA_HOME路径是否正确,以及Path中是否真的包含了%JAVA_HOME%\bin。有时需要关闭命令提示符窗口重新打开,或者重启计算机。

为了进一步验证,可以编写一个简单的Java程序。在任意目录下新建一个文本文档,重命名为HelloWorld.java,用记事本打开并输入以下代码:

public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello, ippipp.com!");
    }
}

然后在命令提示符中切换到该文件所在目录,执行:

javac HelloWorld.java
java HelloWorld

如果输出“Hello, ippipp.com!”,说明编译和运行环境全部正常。

三、macOS系统下的安装与配置

3.1 下载并安装JDK

macOS用户同样需要从Oracle官网下载对应版本的JDK安装包,通常是一个.dmg.pkg文件。双击打开后,按照安装向导的提示完成安装。默认安装路径为/Library/Java/JavaVirtualMachines/,每个JDK版本会有一个独立的文件夹,例如jdk-17.jdk

安装完成后,可以在“系统偏好设置”中查看Java版本,也可以通过终端验证。

3.2 配置环境变量

macOS默认的shell从Catalina版本开始改为zsh,因此配置文件是~/.zshrc。如果你仍在使用bash,则编辑~/.bash_profile。打开终端,执行以下命令编辑配置文件:

nano ~/.zshrc

在文件末尾添加以下内容:

export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home
export PATH=$JAVA_HOME/bin:$PATH

第一行设置了JAVA_HOME指向JDK的真实路径。注意macOS的JDK目录结构比较特殊,Contents/Home才是真正的根目录。第二行将$JAVA_HOME/bin添加到PATH的最前面,这样系统会优先使用我们指定的Java版本。

保存文件(在nano中按Control+O,回车,再按Control+X退出),然后执行以下命令使配置立即生效:

source ~/.zshrc

3.3 验证配置

在终端中输入:

java -version
javac -version

如果显示版本信息,说明配置成功。如果提示“command not found”,请检查JAVA_HOME路径是否正确。可以先用ls /Library/Java/JavaVirtualMachines/查看实际存在的JDK文件夹名称,然后修改配置文件中的路径。

同样可以创建一个HelloWorld.java文件来测试编译和运行,方法与Windows相同。

四、Linux系统下的安装与配置

4.1 下载并安装JDK

Linux用户可以选择两种方式安装JDK:使用包管理器(如aptyum)或者手动下载压缩包。这里以手动安装为例,因为这种方式可以精确控制版本。

首先,从Oracle官网或OpenJDK镜像站下载Linux版本的压缩包,例如jdk-17_linux-x64_bin.tar.gz。然后通过终端将其解压到目标目录,通常选择/usr/local/

sudo tar -zxvf jdk-17_linux-x64_bin.tar.gz -C /usr/local/

解压后,/usr/local/下会出现一个jdk-17文件夹。为了方便管理,可以将其重命名或建立软链接。

4.2 配置环境变量

Linux的环境变量通常在/etc/profile(全局生效)或~/.bashrc(当前用户生效)中配置。推荐编辑/etc/profile,这样所有用户都能使用。使用vimnano打开文件:

sudo vim /etc/profile

在文件末尾添加以下内容:

export JAVA_HOME=/usr/local/jdk-17
export PATH=$JAVA_HOME/bin:$PATH
export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar

CLASSPATH变量告诉Java虚拟机到哪里去寻找类文件。.:表示当前目录,后面是JDK自带的一些工具类库。虽然现代Java开发中很少手动设置CLASSPATH(因为构建工具会自动处理),但为了兼容一些老旧的教程和框架,保留它是稳妥的做法。

保存退出后,执行以下命令使配置生效:

source /etc/profile

4.3 验证配置

在终端中执行:

java -version
javac -version

如果输出版本信息,说明配置成功。如果提示找不到命令,可以检查PATH是否包含了$JAVA_HOME/bin,或者尝试重新登录会话。

同样可以编写HelloWorld.java进行测试,确保编译和运行都没有问题。

五、常见问题与解决方法

5.1 命令提示“不是内部或外部命令”或“command not found”

这是最常见的问题。首先确认JAVA_HOME变量是否设置正确,路径中不要有多余的空格或引号。其次检查Path变量是否包含了%JAVA_HOME%\bin(Windows)或$JAVA_HOME/bin(macOS/Linux)。另外,配置完成后一定要重新打开终端或命令提示符窗口,或者执行source命令,否则旧会话不会加载新配置。

5.2 安装路径包含中文或空格

某些Windows用户在安装时选择了“Program Files (x86)”或含有中文的文件夹,导致javac编译时出现“错误:编码GBK的不可映射字符”或找不到文件。解决办法是卸载JDK,重新安装到纯英文路径下,例如D:\Java\jdk-17

5.3 多个Java版本冲突

如果系统中安装了多个JDK版本,可能会出现java -version显示的版本与你期望的不一致。此时需要检查PATH变量中各个Java路径的顺序,排在前面的会被优先使用。建议将需要的JDK的bin目录放在最前面。在macOS和Linux下,还可以使用update-alternatives命令来管理默认版本。

5.4 配置后依然无法编译运行

除了环境变量问题,还可能是Java源文件本身有错误。例如,文件名必须与类名完全一致(包括大小写),否则编译会报错。另外,如果在编写代码时使用了中文注释,而系统默认编码不是UTF-8,也可能导致编译失败。建议在文件开头加上-encoding UTF-8参数,或者将IDE的编码设置为UTF-8。

六、总结

JDK的安装和环境变量配置是Java开发的基础门槛,虽然步骤看起来琐碎,但只要理解了每一步的目的,就能轻松掌握。JAVA_HOME指向JDK根目录,Path指向bin子目录,CLASSPATH指向类库路径——这三者构成了Java运行的基本骨架。

无论你使用的是Windows、macOS还是Linux,配置思路都是相通的。建议在完成配置后,立即编写一个简单的“HelloWorld”程序进行验证,这不仅能检验环境是否正常,也是你Java编程之旅的第一个里程碑。从此,你就可以在命令行中自由地编译和运行Java程序,迈入面向对象编程的世界。

JavaJDK环境变量配置开发环境搭建修改时间:2026-08-23 02:48:41

免责声明:​ 已尽一切努力确保本网站所含信息的准确性。网站内容多为原创整理与精心编撰,观点力求客观中立。本站旨在免费分享,内容仅供个人学习、研究或参考使用。若引用了第三方作品,版权归原作者所有。如内容涉及您的权益,请联系我们处理。
内容垂直聚焦
专注技术核心技术栏目,确保每篇文章深度聚焦于实用技能。从代码技巧到架构设计,为用户提供无干扰的纯技术知识沉淀,精准满足专业提升需求。
知识结构清晰
覆盖从开发到部署的全链路。AI、前端、编程、数据库、服务器、建站、系统层层递进,构建清晰学习路径,帮助用户系统化掌握开发与运维所需的核心技术。
深度技术解析
拒绝泛泛而谈,深入技术细节与实践难点。无论是数据库优化还是服务器配置,均结合真实场景与代码示例进行剖析,致力于提供可直接应用于工作的解决方案。
专业领域覆盖
精准对应开发生命周期。从前端界面到后端编程,从数据库操作到服务器运维,形成完整闭环,一站式满足全栈工程师和运维人员的技术需求。
即学即用高效
内容强调实操性,步骤清晰、代码完整。用户可根据教程直接复现和应用于自身项目,显著缩短从学习到实践的距离,快速解决开发中的具体问题。
持续更新保障
专注既定技术方向进行长期、稳定的内容输出。确保各栏目技术文章持续更新迭代,紧跟主流技术发展趋势,为用户提供经久不衰的学习价值。