跳到主要内容

SDKMAN! 在 macOS 上的安装与 Java 多版本管理

什么是 SDKMAN!​

SDKMAN! 是一个用于管理多个软件开发套件的并行版本的工具。它提供了一个便捷的命令行界面,可以轻松安装、切换和管理各种 SDK(Software Development Kit),包括 Java、Groovy、Scala、Kotlin 等。

安装 SDKMAN!​

前置要求​

  • macOS 系统
  • curl 命令行工具
  • zip 和 unzip 工具
  • Bash 或 Zsh shell

安装步骤​

打开终端,运行以下命令:

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

安装完成后,按照提示执行以下命令使环境变量生效:

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

或者重启终端。

验证安装​

sdk version

如果看到版本信息,说明安装成功。

安装 Java​

查看可用的 Java 版本​

sdk list java

这将列出所有可用的 Java 发行版和版本。

安装指定版本的 Java​

安装最新的 LTS 版本(推荐)​

sdk install java

安装特定版本​

sdk install java 17.0.17-tem
sdk install java 21.0.9-tem

常用 Java 发行版标识:

  • tem - Temurin(AdoptOpenJDK 的继任者)
  • amzn - Amazon Corretto
  • librca - Liberica JDK
  • zulu - Azul Zulu

管理 Java 版本​

查看已安装的 Java 版本​

sdk list java | grep installed

或

sdk current java

切换 Java 版本(临时)​

sdk use java 17.0.9-tem

此切换仅在当前终端会话有效。

切换 Java 版本(永久)​

sdk default java 17.0.9-tem

此切换将设置全局默认版本。

在特定目录使用特定 Java 版本​

在项目根目录创建 .sdkmanrc 文件:

echo "java=17.0.9-tem" > .sdkmanrc

进入该目录后运行:

sdk env

安装 Maven​

查看可用的 Maven 版本​

sdk list maven

这将列出所有可用的 Maven 版本。

安装指定版本的 Maven​

安装最新的 Maven 版本(推荐)​

sdk install maven

安装特定版本​

sdk install maven 3.9.9
sdk install maven 3.9.8

Maven 与 Java 版本兼容性​

Maven 版本最低 Java 版本推荐Java版本
Maven 3.9.xJava 8Java 11+
Maven 4.0+Java 17Java 17+
Maven 3.8.xJava 7Java 8+

注意:使用 SDKMAN! 可以方便地为不同项目切换 Java 和 Maven 版本的组合。

管理 Maven 版本​

查看已安装的 Maven 版本​

sdk list maven | grep installed

或

sdk current maven

切换 Maven 版本(临时)​

sdk use maven 3.9.9

此切换仅在当前终端会话有效。

切换 Maven 版本(永久)​

sdk default maven 3.9.9

此切换将设置全局默认版本。

在特定目录使用特定 Maven 版本​

在项目根目录创建 .sdkmanrc 文件:

echo "java=17.0.9-tem" > .sdkmanrc
echo "maven=3.9.9" >> .sdkmanrc

进入该目录后运行:

sdk env

验证 Maven 安装​

mvn -version

输出示例:

Apache Maven 3.9.9
Maven home: /Users/username/.sdkman/candidates/maven/3.9.9
Java version: 17.0.9, vendor: Eclipse Adoptium
Default locale: zh_CN, platform encoding: UTF-8
OS name: "Mac OS X", version: "14.0", arch: "aarch64"

Maven 配置​

配置国内镜像源(加速依赖下载)​

编辑 Maven 配置文件 ~/.m2/settings.xml(如果不存在则创建):

<settings>
<mirrors>
<!-- 阿里云镜像 -->
<mirror>
<id>aliyun</id>
<mirrorOf>central</mirrorOf>
<name>Aliyun Maven Mirror</name>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
</mirrors>
</settings>

其他可选镜像源:

提供商URL
华为云https://repo.huaweicloud.com/repository/maven/
腾讯云https://mirrors.cloud.tencent.com/nexus/repository/maven-public/
网易云https://mirrors.163.com/maven/repository/maven-public/

配置本地仓库位置​

在 settings.xml 中添加:

<settings>
<localRepository>/path/to/your/local/repo</localRepository>
</settings>

常用命令​

SDKMAN! 命令​

# 更新 SDKMAN!
sdk update

# 更新所有已安装的 SDK
sdk upgrade

# 卸载 Maven 版本
sdk uninstall maven 3.8.8

# 设置 Maven 主目录环境变量
sdk home maven 3.9.9

# 离线模式(避免网络请求)
sdk offline enable
sdk offline disable

Maven 命令​

# 创建新项目
mvn archetype:generate -DgroupId=com.example -DartifactId=my-app

# 编译项目
mvn compile

# 运行测试
mvn test

# 打包项目
mvn package

# 清理构建
mvn clean

# 安装到本地仓库
mvn install

# 跳过测试打包
mvn package -DskipTests

# 查看依赖树
mvn dependency:tree

# 查看有效 POM
mvn help:effective-pom

Maven 环境变量​

# 设置 Maven 内存(在 ~/.mavenrc 或环境变量中)
export MAVEN_OPTS="-Xms256m -Xmx1024m"

# 设置 Maven 仓库镜像
# 通过 settings.xml 配置(推荐)