如何在macOS上安装旧版本的Xcode

如何在macOS上安装旧版本的Xcode

  1. 大全前端 🛫
  2. 2025-12-15 18:20
  3. 4 min read

上周末下班前看到我的macOS15.7系统软件更新中提示Xcode有更新,本着小版本能更则更的原则就更新了。今天发现竟然是更新到了Xcode 26.1版本,然后发现老项目打不开了,又更新到了Xcode 26.2版本,发现项目中有个废弃的SDK被移除了,只能安装一个旧版本的Xcode先解决打包构建的问题。

获取旧版本Xcode安装文件

Apple 官方和社区提供了多种获取旧版本 Xcode 的途径,但都需要登录 Apple 账户(不需要是你开发App时使用的账户)。我们今天只记录下通过Apple官方获取旧版本Xcode的方法。

登录Apple账户

访问并登录Apple 开发者网站

下载安装文件

打开Apple Developer Downloads页面,往下划拉到我们需要的版本,比如Xcode 16.4版本(可能Apple开发者工具都和Xcode相关,所以输入Xcode检索没看到明显的结果变化)。点击View Details按钮会展开.xip格式的安装包,形如Xcode 16.4.xip,我们直接点击下载即可。

Xcode_16.4

安装及并行运行

Xcode 的设计允许您在同一台 Mac 上同时安装和使用多个大版本的 Xcode。

解压安装文件

找到下载完成的.xip文件,双击它来解压。这可能需要一些时间,解压后会生成一个名为Xcode.app的文件。

重命名和移动

尽量不要覆盖你当前使用的Xcode版本(就是当前在Applications目录中存在的Xcode.app),比如我的是Xcode 26.2

把解压完成的Xcode.app应用文件重命名,例如Xcode_16.4.app

把重命名后的Xcode_16.4.app应用文件移动到Applications目录中。

此时,你已经拥有了两个并行运行的Xcode版本:Xcode 26.2Xcode 16.4

使用旧版本Xcode打开项目

Finder中,右键点击您的项目文件(.xcodeproj.xcworkspace),选择“打开方式”,然后选择您安装的旧版本Xcode(例如Xcode_16.4.app)。

这样,您就可以使用旧版本的Xcode来打开和编辑您的项目了。

指定命令行工具(看需求)

默认情况下,macOS的命令行工具(如gitswift等)会链接到 /Applications/Xcode.app。如果您希望将命令行工具切换到旧版本,可以使用以下命令:

sudo xcode-select --switch /Applications/Xcode_16.4.app/Contents/Developer

在需要使用新版 Xcode 26.2 时,您需要将路径再切换回来:

sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
Mac Xcode