Xcode Command Line Tools 完全指南：版本对照、安装与多版本管理

macOS/iOS 开发者必备参考：快速查询版本对应关系，掌握多版本安装与切换技巧，解决 CI 环境兼容性问题。

版本对照表

Xcode 版本	Command Line Tools 版本	支持的 macOS 版本
Xcode 16.x	16.x	macOS Sequoia 15+
Xcode 15.x	15.x	macOS Sonoma 14+
Xcode 14.x	14.x	macOS Ventura 13+ / Sonoma 14
Xcode 13.x	13.x	macOS Monterey 12+ / Ventura 13
Xcode 12.x	12.x	macOS Big Sur 11+ / Monterey 12
Xcode 11.x	11.x	macOS Catalina 10.15+ / Big Sur 11
Xcode 10.x	10.x	macOS High Sierra 10.13.4+ / Mojave 10.14 / Catalina 10.15

查看已安装的版本

方法一：查看包信息

pkgutil --pkg-info=com.apple.pkg.CLTools_Executables

方法二：查看 Xcode 路径

xcode-select -p

方法三：查看编译器版本

gcc --version
# 或
clang --version

安装与切换

安装 Command Line Tools

xcode-select --install

切换 Xcode 版本

sudo xcode-select --switch /Applications/Xcode.app

切换到 Xcode 命令行工具

sudo xcode-select --switch /Library/Developer/CommandLineTools

安装指定版本的三种方案

在 macOS 上，Xcode Command Line Tools 是可以安装指定版本的，但方式和普通 brew install 不一样。

---

方法一（最推荐）：通过 Apple Developer 官网下载指定版本

这是 最标准、最稳定、最可控 的方式。

步骤

1. 打开 Apple 开发者下载页

登录：developer.apple.com/download/al…（需要 Apple ID 登录）

2. 搜索关键词

搜索 Command Line Tools，你会看到类似：

Command Line Tools for Xcode 15.3
Command Line Tools for Xcode 14.2
Command Line Tools for Xcode 13.4

3. 下载 .dmg

例如：Command Line Tools for Xcode 14.2.dmg

4. 安装

双击 dmg → 运行 pkg 安装即可。

5. 切换当前生效版本

xcode-select -p
sudo xcode-select --switch /Library/Developer/CommandLineTools

---

方法二：通过 softwareupdate 安装（只能装 Apple 当前提供的版本）

这个方法 不能选版本，只能安装 Apple 当前推送版本。

查看可安装版本

softwareupdate --list

如果看到：

Command Line Tools for Xcode-15.3

安装

softwareupdate --install "Command Line Tools for Xcode-15.3"

---

方法三（高级）：通过完整 Xcode 控制 CLI Tools 版本

这是 iOS / Flutter / CI 工程师最常用方式

安装多个完整 Xcode，例如：

/Applications/Xcode_14.2.app
/Applications/Xcode_15.3.app

切换版本

sudo xcode-select -switch /Applications/Xcode_14.2.app

这样以下工具全部跟着切换：

• clang
• git
• xcodebuild
• SDK
• Simulators

CLI Tools 会自动匹配 Xcode 版本

这是以下场景的标准做法：

• CI 打包机
• Flutter / iOS 多版本构建
• fastlane
• Jenkins

---

xcodes CLI - 现代 Xcode 多版本管理工具

xcodes 是目前最优秀的命令行工具，用于安装和切换多个 Xcode 版本。

安装方式

方法一：Homebrew（推荐）

brew install xcodesorg/made/xcodes

这是经过开发者 ID 签名和公证的版本，无需预先安装 Xcode 即可使用。

方法二：下载发布版本

从 Releases 页面 下载最新的已签名版本。

方法三：使用 Mint

mint install XcodesOrg/xcodes

方法四：从源码构建

git clone https://github.com/XcodesOrg/xcodes
cd xcodes
make install

注意：从源码构建需要 Xcode 12.0 或更高版本。

常用命令

安装特定版本的 Xcode

# 安装指定版本
xcodes install 10.2.1
xcodes install 11 Beta 7
xcodes install 11.2 GM seed

# 从本地路径安装
xcodes install 9.0 --path ~/Archive/Xcode_9.xip

# 安装最新的预发布版本
xcodes install --latest-prerelease

# 安装到指定目录
xcodes install --latest --directory "/Volumes/Bag Of Holding/"

# 使用实验性快速解压
xcodes install --latest --experimental-unxip

首次使用会提示输入 Apple ID 和密码，也可以通过环境变量设置：

export XCODES_USERNAME="your-apple-id@example.com"
export XCODES_PASSWORD="your-app-specific-password"

管理已安装版本

# 列出所有可安装的版本
xcodes list

# 列出已安装的版本
xcodes installed

# 更新可用版本列表
xcodes update

# 切换当前活动的 Xcode
xcodes select

# 卸载指定版本
xcodes uninstall 14.2

# 仅下载不安装
xcodes download 15.3

安装运行时

# 列出可用运行时（包括 Beta 版）
xcodes runtimes --include-betas

# 安装特定运行时
xcodes runtimes install "iOS 17.0-beta1"

高级特性

.xcode-version 文件

推荐在项目根目录创建 .xcode-version 文件，显式声明项目所需的 Xcode 版本：

14.2.0

这对于 CI 环境和团队协作非常有用。

加速下载

如果安装了 aria2（brew install aria2），xcodes 会自动使用它进行多线程下载，速度可提升 3-5 倍。

Shell 自动补全

Zsh（配合 oh-my-zsh）：

mkdir ~/.oh-my-zsh/completions
xcodes --generate-completion-script > ~/.oh-my-zsh/completions/_xcodes

为什么选择 xcodes？

特性	xcodes	手动管理
版本切换	一条命令	手动路径切换
版本发现	自动列出所有版本	手动搜索官网
下载管理	自动断点续传	浏览器下载
认证管理	Keychain 自动保存	每次手动输入
CI 友好	是	否

官方资源

• GitHub: github.com/XcodesOrg/x…
• 相关应用: Xcodes.app（图形界面版本）

---

Xcodes.app - 图形化 Xcode 多版本管理工具

Xcodes.app 是 xcodes CLI 的图形界面版本，提供最简单的 Xcode 安装和切换体验——只需点击鼠标即可完成。

如果你更习惯使用图形界面而不是命令行，Xcodes.app 是最佳选择。

系统要求

版本	最低 macOS 版本
v1.x	macOS 11+
v2.x	macOS 13+
v3.x	macOS 13+（支持架构变体和新图标）

安装方式

方法一：Homebrew（推荐）

brew install --cask xcodes

这是经过开发者 ID 签名和公证的版本，无需预先安装 Xcode 即可使用。

方法二：手动安装

1. 从 Releases 页面 下载 Xcodes.zip
2. 解压后将 Xcodes.app 移动到 /Applications 目录
3. 双击启动即可使用

主要功能

Xcode 版本管理

• 列出所有可用版本：从 Xcode Releases 数据或 Apple 开发者网站获取
• 一键安装：全自动安装流程，无需手动操作
• 快速下载：使用 aria2 多线程下载，速度提升 3-5 倍
• 断点续传：网络错误后自动恢复安装
• 一键切换：点击按钮即可通过 xcode-select 切换版本

版本信息查看

• 发布说明
• 操作系统兼容性
• 包含的 SDK 和编译器信息

运行时/平台管理

• 支持安装 Platform/Runtimes
• 点击平台即可自动安装
• 注意：iOS 18+、tvOS 18+、watchOS 11+、visionOS 2+ 需要安装并激活 Xcode 16.1 Beta 3+

Apple Silicon 变体

• 从 Xcode 26 开始，Apple 提供 Apple Silicon 和 Universal 两种变体
• 支持为 Xcode 和每个运行时选择特定变体
• 安装 Apple Silicon 运行时变体需要激活 Xcode 26

实验性功能

• 快速解压：启用后可提升解压速度高达 70%
• 基于 saagarjha/unxip 的优秀工作
• 可能存在 Bug 和高内存使用

认证支持

• Apple ID：下载 Xcode 需要登录
• 安全密钥：支持安全密钥认证
• Keychain 集成：自动保存凭证，无需重复输入

界面特性

• 深色/浅色模式：自动适配系统主题
• 多语言支持：包括简体中文（感谢 @megabitsenmzq）和繁体中文（感谢 @itszero）

使用场景对比

特性	Xcodes.app	xcodes CLI	手动管理
操作方式	图形界面	命令行	浏览器 + 终端
易用性	⭐⭐⭐⭐⭐	⭐⭐⭐⭐	⭐⭐
自动化程度	全自动	全自动	手动
CI 友好	否	是	否
适合人群	所有开发者	高级用户	-

推荐使用组合

• 日常开发：Xcodes.app（可视化、直观）
• CI/CD：xcodes CLI（可脚本化）
• 团队协作：两者结合，使用 .xcode-version 文件统一版本

官方资源

• GitHub: github.com/XcodesOrg/X…
• 官网: xcodes.app

---

官方下载

• Apple Developer Downloads（需要 Apple ID 登录）

重要提示

xcode-select --install 的限制

这个命令：

• 永远只能安装 Apple 当前最新 CLI Tools
• 不能选版本
• 不能回退版本
• CI 环境非常危险

---

最佳工程实践（资深 iOS 工程师方案）

如果你符合以下情况：

• 用 fastlane
• 用 Flutter
• 有 CI
• 要打历史版本
• 要多 SDK

最佳实践是：

只安装完整 Xcode
用 xcode-select 切换
不要单独装 CLI Tools

这是：

• 最稳定
• 最可控
• 最接近 Apple 官方构建环境