看起来你的 Mac 上还没有安装 Homebrew。这是 macOS 上最常用的包管理器,我们先来安装它。
1 安装 Homebrew
1.1 第一步:安装 Homebrew
在终端中运行以下命令来安装 Homebrew:
bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
这个命令会:
- 下载并安装 Homebrew
- 安装 Xcode Command Line Tools(如果还没有的话)
- 设置必要的目录权限
安装过程中可能会让你输入密码(你的 Mac 登录密码),还会询问是否继续安装,按回车确认即可。
1.2 第二步:将 Homebrew 添加到 PATH
安装完成后,终端会提示你将 Homebrew 添加到 PATH。根据你使用的芯片类型,添加对应的命令:
如果是 Apple Silicon Mac(M1/M2/M3 芯片):
bash
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
如果是 Intel Mac:
bash
echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/usr/local/bin/brew shellenv)"
1.3 第三步:验证安装
bash
brew --version
如果显示版本号(如 Homebrew 4.x.x),说明安装成功。
2 安装 Java 和 Kotlin
现在有了 Homebrew,就可以轻松安装 Java 和 Kotlin 了:
2.1 安装 JDK 17(LTS版本)
bash
brew install openjdk@17
2.2 设置 Java 环境变量(可参考设置kotlin环境变量)
安装后,设置 JAVA_HOME:
bash
echo 'export JAVA_HOME="/opt/homebrew/opt/openjdk@17"' >> ~/.zshrc
echo 'export PATH="$JAVA_HOME/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
2.3 验证 Java 安装
bash
java -version
2.4 安装 Kotlin 编译器
bash
brew install kotlin
2.5 验证 Kotlin 安装
bash
kotlinc -version
安装后,设置kotlin环境变量
bash
export PATH="/opt/homebrew/bin:$PATH"
2.6 设置kotlin环境变量完整步骤如下:
bash
#正确配置 kotlinc 到 PATH
1. 编辑 .zshrc 文件
bash
nano ~/.zshrc
2. 在文件末尾添加正确的路径
根据你的 Homebrew 安装位置(Apple Silicon Mac),添加:
bash
# Homebrew 路径(基础)
export PATH="/opt/homebrew/bin:$PATH"
# Kotlin 特定路径(如果上面不够)
export PATH="/opt/homebrew/opt/kotlin/bin:$PATH"
3. 保存并退出 nano
按 Ctrl + O 保存
按回车确认
按 Ctrl + X 退出
4. 重新加载配置
bash
source ~/.zshrc
5. 验证配置
bash
which kotlinc
kotlinc -version
6. 关于kotlin find路径和 .zshrc 文件不一样的原因,解释为下:
Homebrew 的路径设计是这样的:
实际安装位置:/opt/homebrew/Cellar/kotlin/2.3.10/bin/kotlinc
符号链接:/opt/homebrew/bin/kotlinc 指向上面的实际文件
PATH 应该包含:/opt/homebrew/bin
所以只要 /opt/homebrew/bin 在 PATH 中,就能找到 kotlinc。
3 快速替代方案(如果不想用 Homebrew)
如果你觉得安装 Homebrew 太麻烦,也可以直接下载 JDK 和 Kotlin 的安装包:
1. 手动安装 JDK
- 访问 Adoptium 官网
- 下载 macOS 版本的 JDK 17
- 双击安装包进行安装
2. 手动安装 Kotlin 编译器
-
下载
kotlin-compiler-x.x.x.zip -
解压到某个目录,比如
/Users/你的用户名/kotlinc -
将该目录的
bin文件夹添加到 PATH:bashecho 'export PATH="$HOME/kotlinc/bin:$PATH"' >> ~/.zshrc source ~/.zshrc
不过,强烈推荐使用 Homebrew,因为它:
- 安装和卸载都很方便
- 更新简单(
brew upgrade) - 自动处理依赖关系
- 不会弄乱系统文件