2. 开发环境搭建：macOS 与 Xcode 安装

做 iOS SDK 编译，第一件事就是把开发环境搭好。我见过不少新手上来就急着写代码，结果编译报错一看——Xcode 版本不对，或者 Command Line Tools 没装。嗯，这些坑我早年都踩过。

说白了，整个编译链条的起点就是 macOS + Xcode。后面所有工具链、脚本、依赖管理，都得在这个基础上跑。所以这章咱们把环境搭建这件事聊透。

2.1 硬件与系统要求

先说说硬件。iOS 编译对硬件有硬性要求，尤其是内存和磁盘。我有个项目同时编译 Debug 和 Release 两个配置，16GB 内存的机器直接爆掉，Swap 疯狂写入，最后等了40分钟。后来升到32GB，舒服多了。

系统版本怎么选？我一般会看目标 SDK 的最低部署目标。比如你要编译的 SDK 需要支持 iOS 14，那 macOS 至少 Ventura 起步。你想想看，Xcode 14 只能跑在 Ventura 上，这是硬绑定。

2.2 Xcode 安装与多版本管理

安装 Xcode 很简单——从 Mac App Store 下载就行。但问题来了：有时候你需要同时维护多个 Xcode 版本。比如我手头一个旧项目用 Xcode 13，新项目用 Xcode 15，两个不能互相覆盖。

这时候我的做法是：App Store 安装最新稳定版，旧版本从Apple Developer Downloads（不用链接，只是说明）手动下载 .xip 文件，解压后放到 /Applications 目录里，改名为 Xcode_13.4.1.app 这样。

2.2.1 使用 xcode-select 切换版本

# 查看当前 Xcode 路径
xcode-select -p

# 切换到特定版本
sudo xcode-select -s /Applications/Xcode_13.4.1.app/Contents/Developer

# 确认切换成功
xcode-select -p

切换之后，所有命令行工具（如 clang、xcodebuild）都会指向那个版本。不过要注意，如果你用 CocoaPods 或 Swift Package Manager，它们用的是 Xcode 路径里的工具链，不是系统自带的。

2.2.2 xip 解压与证书问题

旧版本 Xcode 是 .xip 格式，解压时 macOS 会校验签名。我有一次下载完解压到一半卡住了，等了半小时没反应。后来发现是网络问题，重新下载才搞定。

解压命令很简单：

# 在下载目录执行
xip --expand Xcode_13.4.1.xip

解压后得到 Xcode.app，改个名，拖到 /Applications 就行了。

2.3 Command Line Tools 安装

很多编译脚本依赖 Command Line Tools，而不是完整的 Xcode.app。你可以只安装命令行工具，体积小很多。

# 安装 Command Line Tools
xcode-select --install

装完后，工具链在 /Library/Developer/CommandLineTools 下。不过我个人习惯还是装完整 Xcode，因为有的编译任务需要 UIKit 模拟器相关的 framework，光命令行工具不够。

2.4 验证环境是否就绪

装完别急着写代码，先跑几个命令确认一切正常。

# 检查 Xcode 版本
xcodebuild -version

# 检查 SDK 列表
xcodebuild -showsdks

# 检查编译器版本
clang --version

# 检查 Swift 版本
swift --version

输出里应该能看到你的 Xcode 版本号、iOS SDK 版本、以及 clang/Swift 版本。如果任何一个命令报 “command not found”，说明路径没配好或者 Command Line Tools 没装。

2.5 开发环境知识体系图

下面这张图总结了 macOS + Xcode 安装涉及的核心知识点和决策点。你看完应该能对整个流程有个全局认识。

这张图从左到右展示了三个核心模块，底下还有推荐安装顺序的流程。我建议你安装完每一步后，都停下来验证一下，别等全装完再回头找问题。

2.6 常见问题与解决方案

最后整理几个我实际遇到过的问题，你遇到类似情况可以直接翻这里。