企业官网建设流程全解析

• 文档
• 教程
• 开发工具

本指南以开源仓库 mac-setup（Installing Development environment on macOS）的 Java 安装文档 为骨架，系统讲解 macOS 上 Java 开发环境的完整搭建流程：从理解 JDK 与 JRE 的区别、在 OpenJDK 与 Oracle JDK 之间做出理性选择，到通过 Homebrew 或手动下载两种方式安装 OpenJDK，并额外引入 SDKMAN! 实现多版本 JDK 的并行管理与一键切换。读完本文，你将能够在任何一台新 Mac 上快速、可复现地完成 Java 环境的安装、验证与版本管理，为后续 Java、Scala 等 JVM 生态开发（参见仓库中的 Scala 安装说明）打下基础。

理解 JDK 与 JRE：为什么直接安装 JDK

使用 Java 的前提是安装 JDK（Java Development Kit，Java 开发工具包）或 JRE（Java Runtime Environment，Java 运行时环境）。二者的关系是：JRE 只包含运行 Java 程序所需的 JVM（Java 虚拟机）与核心类库，而 JDK 在 JRE 的全部能力之上，还额外包含编译器javac、调试器等开发工具。

mac-setup 文档的结论非常明确：直接安装 JDK，因为它能完成 JRE 能做的所有事情，还能做更多。换言之，安装 JDK 是"向下兼容"的选择——既能运行已有的.class/.jar程序，也能编译新的 Java 源码，一步到位，无需在两种安装包之间纠结。

选择发行版：OpenJDK 与 Oracle JDK 的异同

在动手安装之前，先回答一个绕不开的问题：装哪个 JDK？当前主流就两大发行版：OpenJDK与Oracle JDK。

文档强调了两者的关键事实：

• 功能与代码同源：OpenJDK 与 Oracle JDK 提供完全相同的功能，甚至构建自同一份代码库，二者在 API、语言特性与行为上没有实质差异；
• 差异仅在打包与授权：OpenJDK 对任何使用场景均免费；Oracle JDK 在生产环境使用则需要付费的商业许可；
• 结论：对于绝大多数个人开发者，OpenJDK 更容易获取和安装，本仓库的安装教程也正是以 OpenJDK 为主线。

这一点从仓库的项目结构可以得到印证：sidebars.ts中 Java 分类（'java/index'、'java/sdkman'）与 Scala 文档 中"确保已安装 Java"的前置要求，都表明 OpenJDK 是这条开发链路默认的基石，无需为个人学习与开发场景引入 Oracle 的商业授权成本。

安装前检查：java -version

无论采用哪种安装方式，第一步都是确认系统中是否已存在 Java。打开终端（Terminal）执行：

java -version

• 若看到类似如下的非空输出，说明 Java 已经安装完成，可以直接进入开发环节：

openjdk version "21.0.2" 2024-01-16 OpenJDK Runtime Environment Homebrew (build 21.0.2) OpenJDK 64-Bit Server VM Homebrew (build 21.0.2, mixed mode, sharing)

注意输出中的三个关键信息：版本号（如 21.0.2）、运行时来源（这里为 Homebrew 构建的 OpenJDK）、以及 64-Bit Server VM 的架构标识，这行输出也是后续验证安装是否成功的"金标准"。

• 若命令无任何输出或报错command not found，则说明系统尚未安装 Java，请继续下面的安装步骤。

方式一：通过 Homebrew 安装 OpenJDK

mac-setup 项目把 Homebrew 定位为"macOS 缺失的包管理器"，并给出了完整的 Homebrew 安装与 PATH 配置说明。如果你的机器尚未安装 Homebrew，请先按以下步骤完成前置准备：

1. 安装 Xcode Command Line Tools（包含编译器等从源码构建所需的工具）：

xcode-select --install

2. 安装 Homebrew 本体：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

3. 按屏幕提示操作，并根据机器架构配置 PATH：Apple Silicon（M1/M2/M3/M4）机型 Homebrew 安装在/opt/homebrew，需在~/.zprofile（Bash 用户为~/.bash_profile）中加入：

eval "$(/opt/homebrew/bin/brew shellenv)"

Intel 机型安装在/usr/local，一般已存在于 PATH 中。

4. 新开一个终端会话后执行brew doctor，无警告并提示 "ready to brew!" 即表示 Homebrew 可用。

安装 openjdk 公式

Homebrew 就绪后，安装 OpenJDK 只需一条命令：

brew install openjdk

这条命令会通过 Homebrew 的公式（Formula）体系拉取并安装当前默认版本的 OpenJDK，整个过程由 Homebrew 管理依赖、缓存与升级路径，后续也可以通过 Homebrew 使用说明 中的brew update、brew upgrade openjdk等命令维护。

查看可用的 JDK 版本

如果你想知道除了默认openjdk之外还有哪些 JDK 可选，可以搜索：

brew search jdk

这会列出大量候选公式，例如不同厂商与不同主版本号的 OpenJDK 变体。文档的忠告是：若非专业 Java 开发者，不必在这些选项上纠结，直接使用默认的openjdk即可——默认版本对绝大多数场景已经足够，且免去了后续选择困难。

安装完成后，重新执行java -version验证：

java -version

看到与上文一致的 OpenJDK 版本输出即表示安装成功。

方式二：手动下载 OpenJDK（Adoptium）

如果你的网络环境、公司策略或版本需求不适合使用 Homebrew，也可以选择手动安装。文档给出的流程是：

1. 打开浏览器访问Adoptium官网（Eclipse 基金会主导的 OpenJDK 发行版项目，也是 OpenJDK 最主流的免费构建之一）；
2. 在站点上选择最新的 LTS（长期支持）版本，下载对应的 macOS 安装包（.dmg 或 .pkg 格式）；
3. 双击安装包，按图形化向导完成安装；
4. 新开一个终端会话（让新配置的环境变量生效），再次执行java -version验证安装结果。

之所以强调"新开终端会话"，是因为 macOS 的 shell 在启动时会重新加载 PATH 等环境变量；旧会话中的环境可能未包含新安装的 Java 路径。这也与 Homebrew 安装后"需要新开终端才能使用 brew"的机制一致（见 Homebrew 安装文档）。

进阶：用 SDKMAN! 管理多个 Java 版本

通过 Homebrew 安装的是单一版本的 OpenJDK。如果工作中需要在多个 JDK 主版本（如 8、11、17、21）之间切换，仓库在 Java 分类中还提供了 SDKMAN! 的完整文档。SDKMAN! 是一款面向大多数 Unix 系系统的 SDK 并行版本管理工具，提供命令行接口（CLI）与 API，用于安装、切换、移除和列出候选 SDK。

安装 SDKMAN!

在终端中执行：

curl -s "https://get.sdkman.io" | bash

按屏幕提示完成安装后，新开终端或手动加载初始化脚本：

source "$HOME/.sdkman/bin/sdkman-init.sh"

验证安装是否成功：

sdk version

正常会输出类似sdkman 5.0.0+51的版本号。

安装最新稳定版 Java

sdk install java

SDKMAN! 会自动下载并安装其维护的最新稳定版 JDK，终端会显示下载进度条与安装日志：

Downloading: java 8u111 In progress... ######################################################################## 100.0% Installing: java 8u111 Done installing!

安装结束后会询问是否将该版本设为默认：

Do you want java 8u111 to be set as default? (Y/n):

回答Y（或直接回车）后，之后所有新开的 shell 都会默认使用该版本：

Setting java 8u111 as default.

常用管理命令

• 安装指定版本：在sdk install后限定版本号即可，例如：

sdk install scala 2.12.1

• 移除版本：

sdk uninstall scala 2.11.6

注意：移除本地版本记录并不会删除本地的实际安装文件，这一点与 Homebrew 的清理机制类似，都是为可能需要的回滚保留余地。

• 列出所有候选 SDK：

sdk list

这会展示 SDKMAN! 支持管理的全部 SDK（Java、Scala、Groovy、Kotlin 等）及其可用版本，是探索和选择版本的核心入口。

验证与环境自检清单

无论选择哪种安装路径，最终都应完成以下自检：

1. java -version能输出 OpenJDK 版本、运行时来源与 VM 架构信息；
2. which java指向的路径与安装方式一致（Homebrew 安装通常位于/opt/homebrew/opt/openjdk或/usr/local/opt/openjdk的符号链接之下）；
3. 若使用 SDKMAN!，sdk current能显示当前生效的 Java 版本。

关联参考

• 本文主体依据：Java 安装文档
• 多版本管理进阶：SDKMAN! 文档
• 前置工具链：Homebrew 安装文档、Homebrew 常用命令
• JVM 生态延伸：Java 就绪后即可安装 Scala 与 sbt 等依赖 JVM 的语言工具链
• 仓库入口：macOS Setup Guide 介绍

• 文档
• 教程
• 开发工具