Java 开发环境搭建(JDK + Maven + IntelliJ IDEA)
安装顺序原则:
- ✅ JDK 是基础:无 JDK,IDEA 和 Maven 无法运行
- ✅ Maven 是构建工具:管理依赖、打包、生命周期
- ✅ IDEA 是开发工具:最后安装,统一集成配置
一、安装与配置 JDK
1. 下载 JDK
- 推荐来源:
- Oracle JDK:www.oracle.com/java/techno…
- OpenJDK(免费推荐):
- 推荐版本:JDK 17 LTS(长期支持)或 JDK 21 LTS
- 下载文件示例:
jdk-17.0.12_windows-x64_bin.exe
2. 安装 JDK
- 双击
.exe运行安装程序 - 关键提醒:
- ❌ 安装路径禁止含空格或中文(如
Program Files) - ✅ 推荐路径:
E:\Java\jdk-17.0.12
- ❌ 安装路径禁止含空格或中文(如
3. 配置环境变量(Windows)
(1)设置 JAVA_HOME
Win + R→ 输入sysdm.cpl→ 【高级】→【环境变量】- 【系统变量】→【新建】:
- 变量名:
JAVA_HOME - 变量值:
E:\Java\jdk-17.0.12
- 变量名:
(2)更新 Path
- 在【系统变量】中找到
Path→【编辑】→【新建】:
(3)验证安装
# 打开 CMD 或 PowerShell
java -version
javac -version
# 输出示例
openjdk version "17.0.12" 2024-07-16 LTS
OpenJDK Runtime Environment Temurin-17.0.12+9 (build 17.0.12+9-LTS)
OpenJDK 64-Bit Server VM Temurin-17.0.12+9 (build 17.0.12+9-LTS, mixed mode)
二、安装 IntelliJ IDEA
1. 下载 IDEA
-
选择版本:
- Community(社区版) :免费,支持 Java/Kotlin/Scala
- Ultimate(旗舰版) :付费,支持 Spring/数据库/Web 开发(学生可申请免费授权)
2. 安装步骤
-
运行安装程序(
.exe) -
自定义安装:
-
安装路径:
E:\Tools\IntelliJ IDEA -
勾选项:
- ☑ 64-bit launcher
- ☑ Add launchers dir to PATH
- ☑ .java file association
- ☑ Update context menu
-
-
完成安装后建议重启电脑(使 PATH 生效)
3. 初次启动配置
- 导入设置:选择 Do not import settings
- UI 主题:推荐
Darcula(暗色护眼) - 插件市场:跳过(后续可手动安装)
- 完成欢迎页
三、安装与配置 Maven
1. 下载 Maven
- 官网:maven.apache.org/download.cg…
- 下载:
apache-maven-3.9.9-bin.zip(截至 2025 年最新稳定版)
2. 解压
- 解压至目录,如:
E:\Java\apache-maven-3.9.9
3. 修改 conf/settings.xml
(1)设置本地仓库路径
-
在 Maven 根目录新建文件夹:
repository -
编辑
conf/settings.xml,定位到<localRepository>(约第 55 行):xml <!-- 取消注释并修改为 --> <localRepository>E:\Java\apache-maven-3.9.9\repository</localRepository>
(2)配置国内镜像(加速依赖下载)
在 <mirrors> 节点内添加(替换原有 <mirror>):
<mirrors>
<!-- 阿里云公共仓库 -->
<mirror>
<id>aliyunmaven</id>
<mirrorOf>*</mirrorOf>
<name>阿里云公共仓库</name>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
<!-- 华为云镜像(备用) -->
<mirror>
<id>huaweicloud</id>
<mirrorOf>central,jcenter</mirrorOf>
<name>Huawei Cloud Mirror</name>
<url>https://repo.huaweicloud.com/repository/maven/</url>
</mirror>
</mirrors>
✅ 注意:新阿里云 URL 已弃用
maven.aliyun.com/nexus/content/groups/public/,请用上述新地址。
4. 配置环境变量
(1)设置 MAVEN_HOME
-
【系统变量】→【新建】:
- 变量名:
MAVEN_HOME - 变量值:
E:\Java\apache-maven-3.9.9
- 变量名:
(2)更新 Path
-
在
Path中新增:%MAVEN_HOME%\bin
(3)验证安装
mvn -v
✅ 正确输出应包含:
Apache Maven 3.9.9 (...)
Maven home: E:\Java\apache-maven-3.9.9
Java version: 17.0.12, vendor: Eclipse Adoptium, runtime: E:\Java\jdk-17.0.12
四、IDEA 中集成 JDK 与 Maven
1. 配置 JDK(全局 & 项目级)
-
全局配置:
File→Settings(Ctrl+Alt+S) →Build, Execution, Deployment→Build Tools→Maven
❌ 此处不配置 JDK,见下方 -
正确路径:
File→Project Structure(Ctrl+Alt+Shift+S)-
Platform Settings → SDKs →
+→Add JDK- 选择
E:\Java\jdk-17.0.12
- 选择
-
Project Settings → Project
Project SDK: 选择刚添加的 JDKProject language level:17
-
2. 配置 Maven
-
File→Settings→Build Tools→MavenMaven home path:E:\Java\apache-maven-3.9.9User settings file:E:\Java\apache-maven-3.9.9\conf\settings.xmlLocal repository: 自动填充为E:\Java\apache-maven-3.9.9\repository
-
✅ 勾选
Always update snapshots
3. 推荐优化配置
| 配置项 | 路径 | 建议值 |
|---|---|---|
| 自动导入 | Editor → General → Auto Import | ☑ Optimize imports on the fly ☑ Add unambiguous imports on the fly |
| 文件编码 | Editor → File Encodings | Global/Project Encoding: UTF-8 ☐ Transparent native-to-ascii conversion(取消勾选,避免 properties 乱码) |
| 控制台编码 | 同上 | Default encoding for consoles: UTF-8 |
| 内存设置 | Help → Edit Custom VM Options | -Xms512m-Xmx2048m |
五、验证:创建 Spring Boot 项目
1. 生成项目
-
File→New→Project -
选择
Spring Initializr -
配置:
- Project SDK:
17 - Language:
Java - Type:
Maven - Group:
com.example - Artifact:
demo - Packaging:
Jar - Java:
17
- Project SDK:
-
依赖:勾选
Spring WebSpring Boot DevTools
2. 编写测试接口
// src/main/java/com/example/demo/HelloController.java
package com.example.demo;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class HelloController {
@GetMapping("/hello")
public String hello() {
return "🎉 JDK + Maven + IDEA + Spring Boot 全链路畅通!";
}
}
3. 运行 & 测试
- 运行
DemoApplication.java的main()方法 - 浏览器访问:http://localhost:8080/hello
✅ 显示:🎉 JDK + Maven + IDEA + Spring Boot 全链路畅通!