Java开发环境配置全攻略：JDK、IDEA与Maven从零到跑通Hello World-平芜编程栈

很多初学Java的朋友，第一道坎根本不是语法，而是环境装不起来。明明照着网上的教程一步步来，最后却卡在java不是内部或外部命令上，或者IDEA打开后编辑器一片红，连个Hello World都跑不起来。我当年在Windows和macOS上帮人排查过无数次环境问题，绝大多数原因都集中在几个固定环节：JDK的版本选错、环境变量的路径配错、IDEA和JDK的关联没配对、以及后面接Maven时仓库和镜像设置不对。这篇就把Java和IDEA的安装配置从头到尾捋一遍，把每一步背后的原理和容易踩的坑都说清楚，希望你看完之后能一次性把所有环节跑通。

这篇内容适合完全零基础的小白，也适合卡在环境配置阶段到处查资料的初学者。涉及JDK下载安装、环境变量配置、IDEA安装与初始化、创建第一个Java项目、以及Maven的安装和IDEA集成。我会把每个关键步骤背后的道理也讲清楚，这样以后换一台电脑、换一个版本，你也能自己举一反三搞定，而不是只会照着截图点击。

1. 装Java之前，先搞懂JDK、JRE、JVM和版本选择

经常有人问我：我去Oracle官网下载Java，为什么里面选项有JDK有JRE，还有各种版本号，到底该下哪个？这个问题不搞清楚，后面配置环境变量时你就会非常困惑。

1.1 JDK、JRE与JVM的关系

先说三个最容易混淆的概念：

JVM（Java Virtual Machine）：Java虚拟机，负责把编译后的字节码翻译成当前操作系统能理解的机器码。
JRE（Java Runtime Environment）：Java运行环境，包含JVM和Java核心类库，作用是让已经编译好的Java程序能在你的电脑上跑起来。
JDK（Java Development Kit）：Java开发工具包，包含JRE的全部内容，额外还提供了javac（编译器）、java（启动器）、jar（打包工具）、javadoc（文档生成工具）等开发必需的工具。

用生活化的话说：JVM是发动机，JRE是装了发动机的整车，JDK是整车加维修工具和配件。

所以你要做开发，就必须装JDK。只装JRE的话，你可以运行电脑上已有的Java程序，但没办法自己写Java代码并编译运行。初学者最容易犯的错就是下载了JRE，结果发现没有javac命令。

1.2 版本选择：Java 8、Java 11、Java 17还是Java 21？

版本选择是劝退初学者的重灾区。目前市面上主流的有下面几个版本：

版本	发布时间	是否LTS（长期支持）	说明
Java 8（1.8）	2014年	是	老项目主力，大量教材和网上教程用这个版本
Java 11	2018年	是	首个在Oracle新收费模式下提供LTS的版本
Java 17	2021年	是	目前很多新项目选择的版本
Java 21	2023年	是	当前最新长期支持版

我从实际经验给你的建议是：如果是全新开始学习、没有特定教程限制，优先选择Java 17或Java 21这种较新的LTS版本。原因很实际，IDEA和主流框架对这两种版本的支持都很成熟，新特性也让你写代码时更容易上手。反观Java 8，虽然老项目里有大量存量，但如果你纯粹是想学基础，没必要一上来就用十几年前版本的语法习惯。

不过要注意一点：如果你是在B站或慕课网跟着某个具体教程学习，教程里用的Java 8，那你就装Java 8。很多老教程用的代码在Java 11以上的版本会出现编译警告甚至直接报错，比如有些反射相关的API在新版本被删除了。工具的版本顺从教程，等基础打牢之后再升级不迟。

1.3 安装包类型：exe、msi、zip怎么选

Oracle官网提供的JDK下载一般有几种格式：

.exe或.msi：图形化安装程序，自动帮你配置好部分内容，适合大多数用户。
.zip或.tar.gz：解压即用，需要手动配置环境变量，适合喜欢“绿色软件”或者不想被安装程序写入注册表的人。

我个人在Windows上更推荐用.zip解压版。好处是你随时可以删掉整个目录来卸载，不会在注册表里留一堆残渣；而且不同版本的JDK可以放在不同的文件夹里，切换版本时只需要改环境变量里的JAVA_HOME指向即可，非常清爽。

macOS上则建议直接用.dmg安装包，或者通过Homebrew安装，步骤更省心。Linux一般用发行版的包管理器，比如apt install openjdk-17-jdk，注意选JDK而不是JRE。

2. JDK环境变量配置：JAVA_HOME、PATH与CLASSPATH的完整说明

为什么JDK安装完了还要配置环境变量？这是新人最容易懵的地方。简单说，环境变量的作用是告诉操作系统：程序员常用的命令放在哪个目录下。你每次在命令行敲java或javac，系统默认只会在当前目录和系统环境变量PATH中列出的目录里找这个命令。如果不把JDK的bin目录加进PATH，系统就找不到命令，会提示“不是内部或外部命令”。

2.1 下载并解压JDK

打开Oracle官网或Adoptium（Eclipse Temurin）官网，下载对应操作系统的安装包。Adoptium提供的是开源JDK，免费且无坑，很多开发者的首选。

下载后如果是.zip，解压到你想要的位置。建议目录路径不要有中文和空格，比如 Windows 上我习惯放在D:\dev\jdk-17或C:\Java\jdk-17。路径里有空格容易导致某些老旧工具解析出错，虽然IDEA自己处理得好，但命令行下偶尔会踩坑。

2.2 配置JAVA_HOME

JAVA_HOME是一个约定俗成的环境变量名，很多工具比如IDEA、Maven、Tomcat、Hadoop都会读取它来定位JDK路径。配置步骤如下：

Windows 系统按Win键，搜索“环境变量”，打开“编辑系统环境变量”。
点击“环境变量”。
在“系统变量”区域点击“新建”，变量名填JAVA_HOME，变量值填JDK解压目录的完整路径，比如D:\dev\jdk-17。
一路点“确定”。

为什么必须配这个变量？因为后续你安装Maven或部署项目时，许多脚本会通过%JAVA_HOME%来找到JDK，如果你每次都要改一遍路径，会非常痛苦。有了这个统一入口，切换JDK版本时就只需要改JAVA_HOME的指向。

2.3 配置PATH

接下来把JDK的bin目录加入PATH：

在“系统变量”中找到名为Path的变量，双击打开。
点击“新建”，添加一行%JAVA_HOME%\bin。
注意是%JAVA_HOME%\bin，不是%JAVA_HOME%。bin目录里才是java.exe、javac.exe这些可执行文件。

提示：某些教程会让你把CLASSPATH也配一遍，变量值设为.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar。Java 9引入了模块化机制之后，这块基本不需要手动配置了，你只要记着现在不要配CLASSPATH，省得给自己找麻烦。真的不用配，别管那些老教程怎么说。

2.4 验证安装是否成功

配置完之后，关键一步来了：验证。

打开新的命令行窗口（注意，必须是新的窗口，因为旧窗口的环境变量不会自动刷新），依次输入下面的命令：

java -version javac -version

如果看到类似下面这样的输出，说明JDK已经可以使用了：

java version "17.0.8" 2023-07-18 LTS Java(TM) SE Runtime Environment (build 17.0.8+7-LTS-211) Java HotSpot(TM) 64-Bit Server VM (build 17.0.8+7-LTS-211, mixed mode, sharing)

java -version验证的是运行环境，javac -version验证编译器。两个命令都能正常输出版本号，才算真正配置成功。如果第一个有输出但第二个报“找不到命令”，通常说明你的JDK只装了JRE，或者PATH配错到了JRE目录。

3. IDEA的版本选择与安装过程详解

JDK环境搞定之后，接下来是开发工具。IntelliJ IDEA是目前绝大多数Java开发者在用的IDE，比Eclipse更智能也更省心。不过IDEA有Community版和Ultimate版之分，好多新手在这里就开始纠结。

3.1 Community社区版和Ultimate旗舰版怎么选

IDEA的官方版本分两种：

Community Edition（社区版）：免费开源，支持Java、Kotlin、Groovy等JVM语言的基础开发，还支持Git、Maven、Gradle这些基础集成。
Ultimate Edition（旗舰版）：付费商业版，额外支持Spring、微服务、数据库工具、前端JavaScript/Vue等，功能非常全。

如果你还在学Java基础阶段，Community版完全够用。等你以后要做Spring Boot或者更复杂的Web项目时，再考虑Ultimate版也不迟。JetBrains对在校学生有免费教育授权，如果你符合条件，可以直接申请使用Ultimate版。

这里我必须多说一句：不要去找所谓的“破解版”或“激活码”。这种资源一方面有版权和安全隐患，另一方面很多网上流传的激活服务器会盗你电脑里的信息。JetBrains针对学生和开源开发者有免费政策，普通个人开发者也有很多打折活动，花点钱支持正版工具，对你自己的职业习惯养成也是好事。

3.2 IDEA下载与安装

IDEA官网下载地址是www.jetbrains.com/idea，页面会自动识别你的操作系统。下载时务必注意：

选择Ultimate版还是Community版，点击对应的Download。
如果电脑是Windows，注意选64位版本。

Windows下下载到的是.exe安装程序，双击运行，一路Next。有几个安装选项值得留意：

勾选Create Desktop Shortcut，方便以后启动。
勾选Update PATH variable或Add launcher dir to the PATH，这样命令行里可以直接输入idea来启动IDEA。
勾选.java文件关联，以后双击Java文件可以直接用IDEA打开。

安装完成后先别急着打开，直接切换中文和配置JDK也完全可以。不过我想先说一下首次启动的东西。

3.3 首次启动配置：主题、插件与JDK关联

首次打开IDEA，它会让你选择UI主题，左边深色右边浅色，这个随意，后面随时能改。然后会进入欢迎界面。这时候不会自动帮你关联JDK，需要你创建或打开一个项目后，IDEA才会让你选择SDK。

我建议先把JDK关联设置好，这样创建项目时可以少踩坑：

在欢迎界面点击右下角齿轮图标，进入Settings或Customize。
找到Project Structure或者直接快捷键Ctrl+Alt+Shift+S（在项目内打开）。
选择SDKs，点击加号，添加你JDK的安装路径。

如果你在创建项目时发现没有可用的SDK，直接在Project SDK下拉框里点Add JDK，然后选择到刚刚的D:\dev\jdk-17目录，IDEA会自动识别。

3.4 中文语言包设置

IDEA本身默认英文界面，很多英文不太好的朋友会想去安装中文语言包。方法很简单：

打开Settings->Plugins。
搜索Chinese Language Pack，这是JetBrains官方出的中文插件。
点击Install，安装完成后重启IDEA即可。

不过我想给个建议：学习阶段尽量用英文界面，因为网上90%的教程、提问、报错信息都是英文关键词，比如 “Project Structure”、“Module”、“SDK”。你习惯了英文界面，以后查资料或者和人协作也会更顺畅。中文语言包装一下没问题，但至少要把关键术语记住对应的英文。

4. 配置Maven：IDEA项目构建的关键一步

很多初学者一开始不理解为啥要装Maven。以为装好JDK和IDEA就能写代码了，但实际开发中，你要引用第三方库，比如数据库驱动、JSON解析库。手动下载jar包再放到项目里是远古时代的方式，Maven就是为了解决这个痛点出现的构建和依赖管理工具。

4.1 Maven是什么，以及为什么需要它

Maven的核心能力有两点：

依赖管理：你只需要在pom.xml里声明要用的第三方库，Maven会自动从中央仓库下载到本地，并帮你解决依赖之间的版本冲突。
构建打包：用统一的生命周期命令完成编译、测试、打包。

可以这么理解：Maven像一个快递中转站，你告诉它你需要什么，它去仓库取货送到你家，还顺便帮你把包裹整理好。

4.2 Maven安装与环境变量配置

Maven本身是一个基于Java的工具，所以必须在JDK配好的前提下安装。步骤：

去Maven官网下载二进制压缩包，比如apache-maven-3.9.6-bin.zip。
解压到目录，比如D:\dev\apache-maven-3.9.6。
同样配置一个环境变量MAVEN_HOME，路径为Maven解压目录。
在PATH中新增一行%MAVEN_HOME%\bin。
打开新的命令行，执行mvn -v，看到Maven和Java版本信息即说明成功。

执行结果类似：

Apache Maven 3.9.6 (bc0240f3c744dd6b6ec2920b3cd08dcc2d9cd5f1) Maven home: D:\dev\apache-maven-3.9.6 Java version: 17.0.8, vendor: Eclipse Adoptium

4.3 settings.xml本地仓库与阿里云镜像配置

Maven默认的中央仓库在海外，国内下载依赖经常慢到怀疑人生。解决方案是修改用户级settings.xml文件，添加阿里云镜像。

文件一般位于D:\dev\apache-maven-3.9.6\conf\settings.xml，打开后在<mirrors>标签内添加：

<mirror> <id>aliyunmaven</id> <mirrorOf>central</mirrorOf> <name>阿里云公共仓库</name> <url>https://maven.aliyun.com/repository/public</url> </mirror>

另外需要配置本地仓库位置。默认情况下Maven会把下载的依赖放在当前用户目录下的.m2\repository，如果你想改到一个更显眼的位置，可以在settings.xml里找到<localRepository>标签，改成你自己的路径：

<localRepository>D:\dev\maven-repository</localRepository>

这样有个好处：重装系统或者清理C盘时，依赖文件不会跟着遭殃。而且以后IDEA项目导包时，也不用反复去远程仓库拉。

4.4 IDEA中集成Maven

IDEA自带了一个Maven，但建议改成你自己安装的这个，这样命令行和IDEA里用的Maven是同一个，行为一致。步骤：

打开Settings->Build, Execution, Deployment->Build Tools->Maven。
把Maven home path指向你Maven解压目录。
在User settings file一项选择刚才改过的settings.xml。
勾选Override，然后确认Local repository显示的是你配置的本地仓库。

如果不改IDEA的Maven设置，项目也能正常构建，但IDEA捆绑的Maven版本和配置与你手动安装的可能不一致，后面排查问题时会多一层干扰因素。

5. 创建第一个Java项目并跑通Hello World

所有环境都配好之后，是时候实际验证一下整个链路是否顺畅了。创建一个最简单的Java项目，跑通Hello World，这个过程能暴露80%以上的配置问题。

5.1 新建项目

打开IDEA，点击New Project（新建项目），接下来要注意几个选项：

Name：项目名称，比如HelloWorld。
Location：项目保存位置。
Language：选择Java。
Build system：这一步会让人困惑。你可以选择IntelliJ（原生）、Maven或Gradle。如果你已经装了Maven，建议选Maven，这样从一开始就适应真实开发流程。
JDK：选择上一步配好的JDK 17或你安装的版本。

选好之后点击Create，等待IDEA自动创建项目结构。如果这一步直接报找不到JDK，说明SDK没关联好，回到Project Structure手动添加。

5.2 理解项目结构

项目创建完成后，左侧的项目目录树中会看到类似这样结构（以Maven为例）：

HelloWorld ├── src │ ├── main │ │ └── java │ │ └── com/example/demo │ │ └── Main.java │ └── test │ └── java ├── pom.xml └── .idea

src/main/java是你的源代码根目录，src/test/java放测试代码，pom.xml是Maven配置文件。IDEA自带的Main.java通常已经写好了最简单的启动类。

5.3 运行Hello World

打开IDEA生成的Main.java，把代码改成：

public class Main { public static void main(String[] args) { System.out.println("Hello World!"); } }

然后点击Main类旁边绿色的三角形运行按钮，选择Run 'Main.main()'。

这时如果控制台输出Hello World!，恭喜你，整个开发环境已经彻底跑通了。如果运行的时候报“Error: Could not find or load main class”，多半是项目构建路径有缓存问题，点一下File->Invalidate Caches / Restart，重新加载后一般就能解决。

提示：第一次运行Maven项目时，IDEA会在后台做依赖索引和下载，底部状态栏可能一直转圈，这期间别频繁点运行。等右下角索引进度条消失后再跑，否则可能报莫名其妙的错误。

6. 安装配置过程中的常见问题与排查链路

最后这一节，把你可能会遇到的高频问题整理成一份排查手册。这些问题我几乎每个月都会在社区和群里见一遍，而且来来回回就那几种原因。

6.1 命令行提示“java不是内部或外部命令”

这个问题90%出在环境变量配置上。排查路径如下：

确认JDK有没有真正安装好。去D:\dev\jdk-17\bin目录里看有没有java.exe和javac.exe。
确认JAVA_HOME有没有配错。注意路径里不能带bin，应该是JDK根目录。
确认PATH里有没有把%JAVA_HOME%\bin加进去。
最关键的一点：你配置完环境变量之后，是否重新打开命令行窗口？旧的窗口不会读取新的环境变量，必须关掉重开。
如果刷新后还是不行，输入echo %JAVA_HOME%和echo %Path%，看变量值是否真的生效了。

6.2 只有java命令，没有javac命令

这种情况通常是你安装的是JRE而不是JDK，或者安装JDK时不小心取消了Development Tools组件的安装。解决办法：重新下载完整的JDK安装包，确保安装时Development Tools、Source Code这些组件是勾选状态。

还有一种可能是PATH里同时存在多个Java路径，系统优先找到了JRE目录。检查一下PATH里有没有类似C:\Program Files (x86)\Common Files\Oracle\Java\javapath的项，把JRE相关的路径删掉，确保%JAVA_HOME%\bin排在前面。

6.3 IDEA里创建项目时没有SDK选项

这说明IDEA没有识别到你安装的JDK。回到File->Project Structure->SDKs，点加号添加JDK，选择JDK安装目录。如果IDEA提示“The selected directory is not a valid home for JDK”，检查你选的路径是不是JDK根目录，手动确认下这个目录里有bin和lib文件夹。

6.4 Maven依赖下载一直失败或超时

依赖下载不下来的原因绝大多数是网络问题。解决方案有两种：

第一种，使用阿里云镜像。在settings.xml中配置镜像（参考4.3节），配置完重启IDEA并重新导入项目。第二种，手动初始化依赖：在命令行项目目录下执行mvn clean compile，观察输出日志。如果命令行下能成功，IDEA里还报错，就在IDEA的Maven工具窗口里点击刷新按钮重新加载。

另外，如果你用的是公司内网，可能需要配置代理，这个就属于特殊场景了，建议直接请教下身边有经验的同事。

6.5 关于“破解版IDEA”的警示

网上搜“IDEA激活码”或“IDEA破解版安装教程”是不良搜索习惯。破解有两种常见手段，一是盗用教育授权或者生成虚假激活码，二是用破解补丁修改IDEA的字节码。前者迟早会失效，后者容易被杀毒软件报警，甚至安装包里被塞进木马。在这些所谓激活工具里发现过恶意程序，这是真实发生过的安全事件，不是危言耸听。

建议的做法是：学生用学校邮箱申请免费授权，职场上让公司买商业授权，个人开发者可以用社区版或者等官方的促销活动。工欲善其事，必先利其器，但前提是工具本身要安全可靠。

写在最后

按照我这篇的顺序一步步来，从JDK到IDEA再到Maven，基本上能覆盖你初期环境搭建的全部需求。我在帮别人配环境时发现，绝大多数问题都不是单点错误，而是“版本不匹配”和“环境变量配置不一致”这种系统性问题。所以我的习惯是，每次换新电脑或者换新版本时，都会把JAVA_HOME、MAVEN_HOME、PATH三项变量的值先echo出来看一眼，确认没有旧版本残留，再创建项目。另外一个小技巧是，如果你打算长期在Windows上开发，把JDK和Maven都统一放在同一个根目录下，比如都放在D:\dev下面，这样路径短、好记、排查方便，比默认安装在C盘Program Files里省心很多。希望这篇能帮你把环境配置这一关顺利跨过去。

Java开发环境配置全攻略：JDK、IDEA与Maven从零到跑通Hello World