总览：配置流程
整个过程可以分为以下几个主要步骤：
- 安装 Java Development Kit (JDK)：这是 Java 开发的核心。
- 安装 IntelliJ IDEA：这是你编写代码的主要工具。
- 配置 IDEA：让 IDEA 识别并使用你安装的 JDK。
- 创建并运行第一个项目：验证环境是否配置成功。
第一步：安装 Java Development Kit (JDK)
JDK 是编译和运行 Java 程序所必需的，它包含了 Java 编译器、Java 运行时环境 和其他开发工具。
如何选择 JDK 版本？
- LTS (Long-Term Support) 版本：推荐大多数开发者使用。JDK 8, JDK 11, JDK 17, JDK 21，LTS 版本会获得长期支持，更稳定,社区资源也更多。
- 最新版本：如果你需要使用最新的 Java 特性，可以选择最新的非 LTS 版本,但要注意可能存在未知问题。
对于新手，强烈推荐从 JDK 17 或 JDK 11 开始，JDK 8 虽然仍在广泛使用，但已经进入长期支持末期,新项目不建议再使用。
安装方式推荐
在 macOS 上，最推荐使用 Homebrew 来管理 JDK，因为它可以轻松地安装、切换和管理不同版本的 JDK。
安装 Homebrew (如果尚未安装)
打开你的终端（Terminal，可以在 应用程序 -> 实用工具 中找到）,然后运行以下命令：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
根据提示完成安装。
使用 Homebrew 安装 JDK
安装完 Homebrew 后，你可以轻松安装 JDK，这里以安装最新的 LTS 版本 JDK 17 为例：
brew install openjdk@17
如果你想安装其他版本,只需修改版本号即可，
brew install openjdk@11(安装 JDK 11)brew install openjdk@21(安装 JDK 21)
配置环境变量 (非常重要！)
Homebrew 安装的 JDK 默认路径不在系统的 PATH 环境变量中，你需要手动配置一下，以便在终端和 IDEA 中都能被正确识别。
打开你的终端，编辑 shell 配置文件（通常是 ~/.zshrc，如果你使用的是 Zsh，这是 macOS Catalina 及以后系统的默认 Shell；如果使用 Bash，则编辑 ~/.bash_profile）。
# 使用 Zsh 的用户 open -e ~/.zshrc # 使用 Bash 的用户 open -e ~/.bash_profile
在文件的末尾添加以下两行（请确保路径与你的实际安装路径一致，可以通过 brew info openjdk@17 查看精确路径）：
# OpenJDK 17 export PATH="/opt/homebrew/opt/openjdk@17/bin:$PATH" export JAVA_HOME="/opt/homebrew/opt/openjdk@17"
注意：
- 如果你是 Intel Mac，路径通常是
/usr/local/opt/openjdk@17。 - 如果你是 Apple Silicon (M1/M2/M3) Mac，路径通常是
/opt/homebrew/opt/openjdk@17。
保存文件后,在终端中运行以下命令让配置立即生效：
source ~/.zshrc # 或者 source ~/.bash_profile
验证 JDK 安装
在终端中输入以下命令：
java -version javac -version
如果看到类似下面的输出，说明 JDK 安装和配置成功了！
openjdk version "17.0.9" 2025-10-17
OpenJDK Runtime Environment Homebrew 17.0.9-1
OpenJDK 64-bit Server VM Homebrew 17.0.9-1 (build 17.0.9+1, mixed mode, sharing)
javac 17.0.9第二步：安装 IntelliJ IDEA
- 下载：访问 JetBrains 官网。
- 选择版本：
- Ultimate (旗舰版)：功能最全，支持所有框架（如 Spring, Android 等）,但需要付费。
- Community (社区版)：对开源开发者免费，功能已经足够强大，支持纯 Java/Kotlin/Groovy 等开发。对于初学者，社区版完全足够。
- 安装：下载
.dmg文件后，像安装普通 Mac 应用一样，将其拖到应用程序文件夹即可。
第三步：配置 IntelliJ IDEA
这是最关键的一步，确保 IDEA 使用的是你刚刚安装的 JDK，而不是系统自带的旧版 Java。
首次启动与初始设置
- 首次打开 IDEA，它会提示你导入设置，选择
Do not import settings。 - 你可以选择一个主题（Dark Mode 体验极佳）。
- 在
Keymap(快捷键) 设置中，你可以选择macOS或Eclipse等你熟悉的方案。
配置 Project Default SDK (项目默认 JDK)
这是让所有新项目都使用你指定的 JDK 的标准做法。
- 打开 IDEA，进入
Preferences...(快捷键 )。 - 在弹出的窗口中，导航到
Build, Execution, Deployment->Build Tools->Maven(或者 Gradle，看你用哪个)。 - 在右侧找到
Runner->VM options for running tests和VM options for running，这里可以先不填，主要配置在 SDK。 - 更重要的地方是：在左侧菜单中，直接搜索
SDK，然后选择SDKs。 - 在右侧的
SDKs列表中，点击 号，选择Add JDK...。 - 在弹出的文件选择器中，导航到你的 JDK 安装路径，这个路径就是你之前在
JAVA_HOME中设置的路径，/opt/homebrew/opt/openjdk@17。 - 选择该文件夹，然后点击
Open，IDEA 会自动识别并添加 JDK 17。 - 添加成功后，你可以选择这个新添加的 JDK，然后点击右侧的
Up按钮，将其设置为 Default SDK。
配置当前项目的 SDK
如果你已经创建了一个项目，或者想为某个特定项目设置 JDK：
- 打开项目后，从顶部菜单栏选择
File->Project Structure...(快捷键 )。 - 在左侧选择
Project。 - 在右侧的
SDK下拉菜单中，选择你刚才添加的 JDK 17。 - 确保
Project language level也与你的 JDK 版本相匹配（使用 JDK 17，则选择17 - Local variable type inference (var)）。
第四步：创建并运行第一个 Java 项目
现在环境已经全部配置好了，我们来创建一个 "Hello, World!" 项目来验证一下。
- 在 IDEA 的欢迎界面，点击
New Project。 - 选择
Java，然后确保SDK一栏已经自动选择了你配置好的 JDK 17。 - 在
Project name中输入你的项目名，hello-java。 - 选择项目存储位置。
- 点击
Create。
IDEA 会创建项目并打开，你会看到一个 src 文件夹。
- 在
src文件夹上右键，选择New->Java Class。 - 输入类名，
Main。 - 在
Main.java文件中,输入以下代码：
public class Main {
public static void main(String[] args) {
System.out.println("Hello, IntelliJ IDEA on macOS!");
}
}
- 在代码编辑器左侧，找到带有绿色三角图标的
Run 'Main.main()'按钮,点击它。 - IDEA 会在下方打开
Run窗口,并输出你的结果：
Hello, IntelliJ IDEA on macOS!如果看到了这个输出，恭喜你！你的 macOS + Java + IntelliJ IDEA 开发环境已经完全配置成功了！
总结与最佳实践
- 使用 JDK 17/11：选择一个稳定的 LTS 版本作为你的主力开发版本。
- 使用 Homebrew 管理 JDK：可以轻松安装和切换不同版本，
brew install openjdk@21，然后在 IDEA 的 SDKs 中添加即可。 - 配置好 Default SDK：在 IDEA 的
Preferences->SDKs中设置好默认 SDK,这样创建新项目时就不需要每次都手动选择了。 - 定期更新：IDEA 和 JDK 都会定期更新，保持更新可以获得最新的功能、性能优化和安全补丁。
希望这份详细的指南能帮助你顺利搭建开发环境！如果你在过程中遇到任何问题,可以随时提问。
