适合刚接触Java或重装系统后的开发者，一文搞定基础开发环境

---

一、前言

无论你是刚开始学 Java，还是换了新电脑/重装了系统，最先要做的一件事就是：搭建好开发环境。

本文将手把手教你从零开始安装并配置：

• JDK（Java 开发工具包）

• Maven（项目管理与构建工具）

• IntelliJ IDEA（主流 Java IDE）

全程附带详细截图 + 命令验证，确保你一次性配置成功。

---

二、安装与配置 JDK

2.1 下载 JDK

推荐使用 JDK 11 或 JDK 17（LTS 长期支持版）。

• 官方下载地址（Oracle）：
  https://www.oracle.com/java/technologies/downloads/

• 推荐使用 OpenJDK（免费开源）：
  https://adoptium.net/

以 Adoptium JDK 17 为例：

1. 选择操作系统（Windows / macOS / Linux）

2. 选择版本 17 (LTS)

3. 下载 .msi（Windows）或 .tar.gz（macOS/Linux）

2.2 安装 JDK

Windows

• 双击 .msi 文件，一路 Next

• 记住安装路径，例如：
  C:\Program Files\Eclipse Adoptium\jdk-17.0.12.7-hotspot

macOS

• 使用 .tar.gz 解压到 /Library/Java/JavaVirtualMachines/

Linux (Ubuntu/Debian)

bash

sudo apt update
sudo apt install openjdk-17-jdk

2.3 配置环境变量

Windows

1. 右键 此电脑 → 属性 → 高级系统设置 → 环境变量

2. 新建系统变量：

   • 变量名：JAVA_HOME

   • 变量值：JDK 安装路径（如 C:\Program Files\...\jdk-17）

3. 编辑 Path 变量，新增：

   text

   %JAVA_HOME%\bin

macOS / Linux

编辑 ~/.bashrc 或 ~/.zshrc：

bash

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

执行 source ~/.bashrc

2.4 验证 JDK

打开命令行（cmd / terminal）：

bash

java -version
javac -version

如果显示版本号（如 17.x.x），说明 JDK 配置成功。

---

三、安装与配置 Maven

Maven 用于管理依赖、构建项目。

3.1 下载 Maven

官网：https://maven.apache.org/download.cgi

• 选择 Binary zip archive（如 apache-maven-3.9.9-bin.zip）

3.2 安装 Maven

Windows

• 解压到 C:\maven

macOS / Linux

• 解压到 /opt/maven

3.3 配置环境变量

Windows

• 新建系统变量：

  • MAVEN_HOME = C:\maven

• 编辑 Path，添加：

  text

  %MAVEN_HOME%\bin

macOS / Linux

bash

export MAVEN_HOME=/opt/maven
export PATH=$MAVEN_HOME/bin:$PATH

3.4 配置本地仓库（可选但推荐）

Maven 默认仓库在用户目录 ~/.m2/repository
你可以修改为其他位置：

• 找到 Maven 安装目录下的 conf/settings.xml

• 修改：

xml

<localRepository>D:/maven-repo</localRepository>

3.5 配置国内镜像（加速下载依赖）

在 settings.xml 的 <mirrors> 节点中添加阿里云镜像：

xml

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

3.6 验证 Maven

bash

mvn -v

输出 Maven 版本 + Java 版本即成功。

---

四、安装 IntelliJ IDEA

4.1 下载 IDEA

官网：https://www.jetbrains.com/idea/download/

• Community（社区版）：免费，完全够用

• Ultimate（旗舰版）：付费，支持 Spring Boot 等更多框架

4.2 安装

Windows

• 双击 .exe，勾选：

  • Create Desktop Shortcut

  • Add "Open Folder as Project"

  • Add launchers dir to the PATH（推荐）

macOS

• 拖到 Applications

4.3 首次启动配置

1. 不导入旧配置

2. 选择主题（Light / Dark）

3. 跳过插件安装（后续可手动）

---

五、在 IDEA 中配置 JDK 与 Maven

5.1 配置 JDK

• 菜单：File → Project Structure → SDKs

• 点击 + → Add JDK → 选择 JDK 安装目录

• 给 IDEA 配置默认 JDK

5.2 配置 Maven

• File → Settings（macOS 为 Preferences）

• 搜索 Maven

• 设置：

  • Maven home path：选择你的 Maven 目录（如 C:\maven）

  • User settings file：指定 settings.xml（并勾选 Override）

  • Local repository：会自动读取 settings.xml 中的配置

https://via.placeholder.com/600x300?text=IDEA+Maven+Setting

建议勾选 Always update snapshots（开发阶段）

5.3 验证 IDEA 可用

• 新建项目：File → New → Project

• 选择 Maven → 选择项目 JDK（就是你刚配置的）

• 创建后，等待 IDEA 下载依赖（右下角进度条）

• 在 src/main/java 下新建一个类，写一个 main 方法输出 Hello World

---

六、常见问题与解决方案

问题	解决方法
java 不是内部或外部命令	检查 JAVA_HOME 和 Path 配置，重启终端
Maven 下载依赖极慢	确认阿里云镜像已正确配置
IDEA 无法识别 JDK	File → Project Structure 中手动添加
mvn 命令找不到	检查 MAVEN_HOME 和 Path 中是否包含 bin 目录
IDEA 中 Maven 使用默认配置	检查 File → Settings → Maven 是否覆盖了 user settings

---

七、总结

你现在已经拥有了一套完整的 Java 开发环境：

• ✅ JDK：编译与运行 Java 程序

• ✅ Maven：管理依赖与构建

• ✅ IDEA：高效的编码工具

下一步你可以：

• 创建第一个 Maven + JDK 17 项目

• 学习 Spring Boot 或 Java 基础语法

---

附：快速环境验证脚本（Windows）

将以下内容保存为 check-java-env.bat 双击运行：

batch

@echo off
echo === Java Version ===
java -version
echo.
echo === Maven Version ===
mvn -v
pause

---

如果你在配置过程中遇到任何问题，欢迎在评论区留言（截图 + 错误信息），我会协助解决。